Beautiful TUI · Powerful CLI · Flexible SDK
Bring modern AI assistance directly to your terminal. No context switching. No browser tabs.
Get startedRun a single command to launch an interactive terminal interface. Chat with AI models, switch between providers, and manage your conversation history—all without leaving your terminal.
Full mouse support, split-pane rendering, and customizable themes make the experience feel native. Explore the rich interface, powerful features, and keyboard shortcuts powered by Textual.
Fast command-line tools for quick questions and scriptable workflows. Get instant AI responses, attach files, and pipe AI assistance into your scripts and automations.
Run batch queries from other commands, attach files, and get plain text or JSON output. Perfect for scripting workflows, DevOps pipelines, code reviews, and automating repetitive tasks with shell integration.
$ consoul chat
╭───────────────────────────────────────────────
│ Profile: default
│ Model: claude-3-5-sonnet-20241022
╰───────────────────────────────────────────────
# ʏᴏᴜ: Explain Python decorators
# ᴀssɪssᴛᴀɴᴛ: Decorators wrap functions to modify
# their behavior. They use @syntax and are powerful
# for logging, caching, and authentication.
# ʏᴏᴜ: /tokens
╭─────────── Token Usage ──────────
│ Messages: 1
│ Tokens: 87 / 200,000 (0.04%)
╰──────────────────────────────────
# ʏᴏᴜ: exit
Goodbye!
Embed AI capabilities in your Python applications with full type safety and async support. Build conversational interfaces, integrate with existing systems, and create automated workflows.
The SDK provides programmatic access to all Consoul features: multi-model support, session management, and image analysis. Perfect for building AI-powered applications and extending workflows.