Calliope AI

Calliope AI brings powerful AI capabilities directly into your notebooks. Chat with AI, generate code, query databases with natural language, and train custom knowledge bases—all from within Lab.

Features Overview

Chat Interface

Open the chat sidebar to have conversations with AI about your code and data:

Ask questions about your codebase
Get explanations and documentation
Debug issues with AI assistance
Use slash commands for specialized tasks

Learn more →

Slash Commands

Quick actions available in the chat:

Command	What It Does
`/learn`	Index files for Q&A
`/ask`	Query learned content
`/generate`	Create new notebooks
`/fix`	Fix code errors
`/clear`	Reset conversation
`/export`	Export chat history

Natural Language SQL

Query databases by asking questions in plain English:

%%calliope ask-sql sales_db
What were our top 10 customers by revenue last quarter?

Learn more →

Direct SQL Execution

Run SQL queries with automatic visualization:

%%calliope run-sql analytics_db --generate-chart
SELECT month, SUM(revenue) FROM sales GROUP BY month

Learn more →

RAG Training

Teach the AI about your data for better accuracy:

%%calliope rag-train mydb
{
    "documentation": ["Revenue excludes refunds", "Q4 = Oct-Dec"]
}

Learn more →

Model Selection

Choose from multiple AI providers and models:

Shortcut	Model
`claude`	Anthropic Claude 3.5 Sonnet
`gpt4o`	OpenAI GPT-4o
`gemini`	Google Gemini 2.0 Flash

Learn more →

Quick Reference

Cell Magic Commands

%%calliope ask-sql <datasource> [--model <model>] [--generate-chart]
Your question in natural language

%%calliope run-sql <datasource> [--generate-chart] [--return-data]
SELECT * FROM table

%%calliope rag-train <datasource>
{"ddl": [...], "documentation": [...], "question": [...], "sql": [...]}

%%calliope add-database
{...connection config...}

%%calliope chat [datasource]
Your message

Line Magic Commands

%calliope help                    # Show help
%calliope list-datasources        # List databases
%calliope get-datasource <id>     # Get database details
%calliope delete-database <id>    # Remove database
%calliope list-models             # Show available models
%calliope list-providers          # Show AI providers
%calliope list-secrets            # Show stored secrets