🧙 Overview: Unleash Your LLM Superpowers

🪄 What is CellMage?

CellMage is your magical companion for Jupyter notebooks, transforming ordinary code cells into powerful LLM interactions! Think of it as having an AI wizard 🧙‍♂️ sitting right next to you while you code, ready to assist whenever you summon it.

Under the hood, CellMage consists of several powerful magical components working together:

  • 🧠 ChatManager: The central orchestrator that handles LLM interactions and manages the conversation flow

  • 📜 HistoryManager: (Deprecated) Previously kept track of your conversation history and managed message persistence. Use ConversationManager instead.

  • 🎭 Personas: Predefined AI personalities with specific system prompts and parameters

  • 📋 Snippets: Reusable context blocks that can be injected into conversations

  • 🔌 Adapters: Connects to different LLM providers (OpenAI, compatible APIs, and more)

  • 💾 Storage: Saves your conversations using SQLite (default) or Markdown files for easy reference

  • 🧩 Integrations: Links CellMage to external tools like Jira, GitHub, GitLab, and Confluence

All these components work seamlessly together to create a frictionless LLM experience in your notebook environment.

✨ A Sprinkle of Magic Dust

With CellMage, you can:

  • 💬 Chat with sophisticated AI models using simple %%llm magic commands

  • 🎭 Switch between different AI personalities (personas) with a flick of your wand

  • 🔮 Turn your entire notebook into an AI chat interface with Ambient Mode

  • 📚 Save your magical conversations for later reference

  • 🧩 Connect to external knowledge sources like GitHub, GitLab, Jira, and Confluence

  • ⚡ Execute Python code generated by the LLM right in your notebook

🚀 Getting Started in 10 Seconds

# Install the magic
!pip install cellmage

# Load the extension
%load_ext cellmage

# Cast your first spell!
%%llm
Tell me a fun fact about wizards in computing history.

🎯 Perfect For…

  • 🧪 Data scientists exploring datasets with AI assistance

  • 💻 Developers getting code explanations and suggestions

  • 📝 Writers crafting documentation with AI help

  • 🎓 Students learning new concepts interactively

  • 🔍 Researchers analyzing complex information

  • ⚙️ Automating repetitive LLM tasks in data workflows

Ready to start your magical journey? Check out the Magic Commands to learn all the spells in your new wizard toolkit!