Open Source · Python · Any Model

The Fast Personal AI Assistant That Works With Any Model

Claude, GPT, Gemini, DeepSeek, Ollama, or your own endpoint. One tool, every model, fully hackable in Python.

Get Started View Recipes
curl -fsSL https://raw.githubusercontent.com/SafeRL-Lab/cheetahclaws/main/scripts/install.sh | bash
CheetahClaws demo — task execution in terminal
33+
Built-in Tools
10+
Model Providers
40K
Lines of Python
341+
Tests Passing

Everything You Need

A complete AI coding assistant that runs in your terminal, works with any model, and extends with plugins.

Multi-Provider

Claude, GPT-4o, Gemini, DeepSeek, Qwen, Kimi, MiniMax, Ollama, or any OpenAI-compatible endpoint. Switch with /model.

💻

33 Built-in Tools

Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebBrowse, ReadPDF, ReadEmail, NotebookEdit, and more — all callable by the AI.

👥

Multi-Agent

Spawn specialized sub-agents (coder, reviewer, researcher) in parallel with git worktree isolation. Background execution with named addressing.

📱

Remote Control

Control from your phone via Telegram, WeChat, or Slack bridges. Job queues, slash commands, and live tool tracking.

🔒

Security

Permission system (auto/manual/plan modes), prompt injection detection, credential filtering in /config, safe stdio wrapper.

🚀

Autonomous Agents

Launch research assistants, bug fixers, paper writers, and auto-coders that run independently. 4 built-in templates + custom.

🎧

Voice Input

Record, transcribe, auto-submit. Offline Whisper — no API key, no subscription. 99 languages.

📚

PDF, Excel, Email

Read PDFs, OCR images, parse spreadsheets, read and send emails — all via natural language commands.

🔌

Plugin System

Install plugins from git URLs. Extend with custom tools, commands, skills, and MCP servers. Full authoring guide included.

Works With Every Model

10+ providers, 200+ models. Cloud or local — your choice.

Anthropic Claude OpenAI GPT-4o / GPT-5 Google Gemini DeepSeek Alibaba Qwen Moonshot Kimi Zhipu GLM MiniMax Ollama (local) LM Studio vLLM Any OpenAI-compatible

See It in Action

Real workflows, real productivity gains.

Code Review with Local Model
# Free, private, nothing leaves your machine
$ cheetahclaws --model ollama/qwen2.5-coder

[project] 12% » Review src/api.py for security
issues and performance problems.

I'll analyze the file...
[Read] src/api.py (142 lines)
[Grep] SQL injection patterns...

Found 3 issues:
1. Line 42: SQL injection via f-string
2. Line 78: Missing rate limiting
3. Line 95: Unvalidated redirect

Local Code Review

Run entirely offline with Ollama. Your code never leaves your machine. The AI reads files, searches for patterns, and gives actionable feedback.

  • Zero cloud, zero API cost
  • Works with any Ollama model
  • Context-aware (reads your project files)

Remote Control via Telegram

Control CheetahClaws from your phone while it runs on your workstation. Send commands, get results, manage tasks.

  • Full slash command passthrough
  • Job queue when AI is busy
  • Also works with WeChat and Slack
Phone → Server
# You (Telegram):
What files changed in the last commit?

# CheetahClaws:
[Bash] git log --oneline -1
[Bash] git diff HEAD~1 --stat

Last commit: "fix auth middleware"
  3 files changed:
  - src/auth.py (+12 -5)
  - tests/test_auth.py (+28)
  - config.yaml (+1)

# You:
Fix the type error on line 42
# CheetahClaws edits the file...
Email + PDF + Excel
[project] » Read the contract at
~/Documents/contract.pdf and summarize
the key payment terms.

[ReadPDF] contract.pdf (24 pages)

Key payment terms:
1. Net 30 payment cycle
2. 2% early payment discount
3. Late fee: 1.5% monthly

[project] » Check my latest emails from
[email protected]

[ReadEmail] 3 emails found
1. "Invoice #4521" - Apr 14
2. "Q1 Report attached" - Apr 10
3. "Budget approval" - Apr 8

Beyond Code

Read PDFs, parse Excel spreadsheets, OCR images, read and send emails — all through natural language.

  • PDF text extraction (50+ pages)
  • OCR in 99 languages
  • Excel/CSV with formatted tables
  • IMAP inbox reading + SMTP sending

More Demos

See the full range of capabilities.

Multi-Agent Brainstorm

Spawn expert personas to debate and synthesize ideas

Brainstorm demo

Autonomous Agent Mode

Agent works proactively in the background without prompts

Proactive demo

SSJ Developer Power Menu

14 workflow shortcuts: brainstorm, review, commit, and more

SSJ demo

Remote Control from Telegram

Control your agent from your phone — send tasks, get results

Telegram remote control demo

Remote Control from WeChat

Control your agent from WeChat (微信) — scan QR, start chatting

WeChat remote control demo

Remote Control from Slack

Control your agent from a Slack channel — team-friendly

Slack remote control demo

Plan Mode

Analyze codebase in read-only mode, write a plan, then implement

Plan mode demo

Multi-Agent Sub-Tasks

Spawn parallel sub-agents with git worktree isolation

Sub-agent demo

Persistent Memory

Save and recall facts, preferences, and decisions across sessions

Memory demo

Multi-Model Switching

Switch between Claude, GPT, Gemini, Ollama mid-conversation

Multi-model demo

Checkpoint & Rewind

Auto-snapshot every turn — rewind files and conversation to any point

Checkpoint demo

Voice Input

Speak your prompt — offline Whisper transcription, 99 languages

Voice input demo

Vision Input

Paste an image and ask questions — works with local and cloud models

Vision input demo

AI Video Factory

Generate videos: story → TTS narration → AI images → subtitles → MP4

Video factory demo

Worker — Auto-Implement Tasks

Automatically implement TODO items from brainstorm output

Worker demo

Tmux Terminal Control

Split panes, run long tasks, capture output — 11 tmux tools

Tmux demo

Cloud Session Sync

Backup conversations to GitHub Gist — resume from any machine

Cloud sync demo

Trading Agent

Autonomous trading agent — monitor markets, analyze signals, execute strategies

Trading agent demo

Shell Escape

Run any shell command inline with !command — git, ls, python, etc.

Shell escape demo

Start Building in 30 Seconds

One command to install. First run guides you through setup. No build step, no daemon, no subscription.

Get Started Read the Docs Contribute
pip install git+https://github.com/SafeRL-Lab/cheetahclaws.git && cheetahclaws --setup