gptme: Your agent in your terminal

in python equipped with local tools: writes code, uses the terminal, browses the web, vision and has MCP support

📜 Personal AI assistant/agent in your terminal, with tools so it can:
Use the terminal, run code, edit files, browse the web, use vision, and much more;
a great coding agent, but is general-purpose to assists in all kinds of knowledge-work, from a simple but powerful CLI.

An unconstrained local alternative to: ChatGPT with “Code Interpreter”, Cursor Agent, etc.
Not limited by lack of software, internet access, timeouts, or privacy concerns (if using local models).

Model tool use evals

Evals — gptme

🛠 Use Cases

• 🖥 Development: Write and run code faster with AI assistance.

• 🎯 Shell Expert: Get the right command using natural language (no more memorizing flags!).

• 📊 Data Analysis: Process and analyze data directly in your terminal.

• 🎓 Interactive Learning: Experiment with new technologies or codebases hands-on.

• 🤖 Agents & Tools: Experiment with agents & tools in a local environment.

Here are some examples:

gptme 'write an impressive and colorful particle effect using three.js to particles.html'  
gptme 'render mandelbrot set to mandelbrot.png'  
gptme 'suggest improvements to my vimrc'  
gptme 'convert to h265 and adjust the volume' video.mp4  
git diff | gptme 'complete the TODOs in this diff'  
make test | gptme 'fix the failing tests'  

🛠 Usage

$ gptme --help  
Usage: gptme [OPTIONS] [PROMPTS]...  
  
  gptme is a chat-CLI for LLMs, empowering them with tools to run shell  
  commands, execute code, read and manipulate files, and more.  
  
  If PROMPTS are provided, a new conversation will be started with it. PROMPTS  
  can be chained with the '-' separator.  
  
  The interface provides user commands that can be used to interact with the  
  system.  
  
  Available commands:  
    /undo         Undo the last action  
    /log          Show the conversation log  
    /tools        Show available tools  
    /edit         Edit the conversation in your editor  
    /rename       Rename the conversation  
    /fork         Create a copy of the conversation with a new name  
    /summarize    Summarize the conversation  
    /replay       Re-execute codeblocks in the conversation, wont store output in log  
    /impersonate  Impersonate the assistant  
    /tokens       Show the number of tokens used  
    /export       Export conversation as standalone HTML  
    /help         Show this help message  
    /exit         Exit the program  
  
  Keyboard shortcuts:  
    Ctrl+J        Insert a new line without executing the prompt  
  
Options:  
  -n, --name TEXT        Name of conversation. Defaults to generating a random  
                         name.  
  -m, --model TEXT       Model to use, e.g. openai/gpt-4o,  
                         anthropic/claude-3-5-sonnet-20240620. If only  
                         provider given, a default is used.  
  -w, --workspace TEXT   Path to workspace directory. Pass '@log' to create a  
                         workspace in the log directory.  
  -r, --resume           Load last conversation  
  -y, --no-confirm       Skips all confirmation prompts.  
  -n, --non-interactive  Force non-interactive mode. Implies --no-confirm.  
  --system TEXT          System prompt. Can be 'full', 'short', or something  
                         custom.  
  -t, --tools TEXT       Comma-separated list of tools to allow. Available:  
                         read, save, append, patch, shell, subagent, tmux,  
                         browser, gh, chats, screenshot, vision, computer,  
                         python.  
  --no-stream            Don't stream responses  
  --show-hidden          Show hidden system messages.  
  -v, --verbose          Show verbose output.  
  --version              Show version and configuration information  
  --help                 Show this message and exit.  

gptme alternatives

Nice recap of AI Assisted Development space
Alternatives — gptme