ErikBjare/gptme
Fork: 147 Star: 2226 (更新于 2024-10-31 05:40:46)
license: MIT
Language: Python .
Your agent in your terminal, equipped with local tools: writes code, uses the terminal, browses the web, vision.
最后发布版本: v0.19.2 ( 2024-10-07 14:37:33)
gptme
/ʤiː piː tiː miː/
Getting Started • Website • Documentation
📜 Personal AI assistant in your terminal, with tools so it can:
Use the terminal, run code, edit files, browse the web, use vision, and much more;
Assists in all kinds of knowledge-work, especially programming, from a simple but powerful CLI.
An unconstrained local alternative to ChatGPT's "Code Interpreter".
Not limited by lack of software, internet access, timeouts, or privacy concerns (if using local models).
📚 Table of Contents
🎥 Demos
[!NOTE] These demos are very out of date and do not reflect the latest capabilities. We hope to update them soon!
Fibonacci (old) | Snake with curses |
---|---|
Steps
|
Steps
|
Mandelbrot with curses | Answer question from URL |
Steps
|
Steps
|
You can find more Demos and Examples in the documentation.
🌟 Features
- 💻 Code execution
- 🧩 Read, write, and change files
- Makes incremental changes with the patch tool.
- 🌐 Search and browse the web.
- Can use a browser via Playwright with the browser tool.
- 👀 Vision
- Can see images referenced in prompts, screenshots of your desktop, and web pages.
- 🔄 Self-correcting
- Output is fed back to the assistant, allowing it to respond and self-correct.
- 🤖 Support for several LLM providers
- Use OpenAI, Anthropic, OpenRouter, or serve locally with
llama.cpp
- Use OpenAI, Anthropic, OpenRouter, or serve locally with
- ✨ Many smaller features to ensure a great experience
- 🚰 Pipe in context via
stdin
or as arguments.- Passing a filename as an argument will read the file and include it as context.
- → Tab completion
- 📝 Automatic naming of conversations
- 💬 Optional basic Web UI and REST API
- 🚰 Pipe in context via
🛠 Developer perks
- 🧰 Easy to extend
- Most functionality is implemented as tools, making it easy to add new features.
- 🧪 Extensive testing, high coverage.
- 🧹 Clean codebase, checked and formatted with
mypy
,ruff
, andpyupgrade
. - 🤖 GitHub Bot to request changes from comments! (see #16)
- Operates in this repo! (see #18 for example)
- Runs entirely in GitHub Actions.
- 📊 Evaluation suite for testing capabilities of different models
🚧 In progress
- 🏆 Advanced evals for testing frontier capabilities
- 🤖 Long-running agents and advanced agent architectures
- 🌳 Tree-based conversation structure (see #17)
- 📜 RAG to automatically include context from local files (see #59)
- 💻 "Computer use" as hyped by Anthropic (see #216)
- 🌐 Web UI frontend (see docs for server)
🛠 Use Cases
- 🎯 Shell Copilot: Figure out the right shell command using natural language (no more memorizing flags!).
- 🖥 Development: Write, test, and run code with AI assistance.
- 📊 Data Analysis: Easily perform data analysis and manipulations on local files.
- 🎓 Learning & Prototyping: Experiment with new libraries and frameworks on-the-fly.
- 🤖 Agents & Tools: Experiment with agents and tools in a local environment.
🚀 Getting Started
Install with pipx:
# requires Python 3.10+
pipx install gptme
Now, to get started, run:
gptme
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'
For more, see the Getting Started guide and the Examples in the documentation.
🛠 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
/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
/tools Show available tools
/help Show this help message
/exit Exit the program
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.
--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.
📊 Stats
⭐ Stargazers over time
📈 Download Stats
🔗 Links
最近版本更新:(数据更新于 2024-10-09 08:34:11)
2024-10-07 14:37:33 v0.19.2
2024-10-05 23:36:22 v0.19.1
2024-10-03 01:44:33 v0.19.0
2024-09-29 21:36:15 v0.18.2
2024-09-27 16:01:36 v0.18.1
2024-09-27 01:15:14 v0.18.0
2024-09-19 22:49:23 v0.17.0
2024-09-16 17:52:25 v0.16.0
2024-09-06 23:34:09 v0.15.0
2024-08-28 20:10:14 v0.14.2
主题(topics):
ai-agents, ai-assistant, anthropic, chatbot, chatgpt, cli, code-generation, llamacpp, llm, llm-agent, llm-apps, openai, openrouter, rag
ErikBjare/gptme同语言 Python最近更新仓库
2024-11-05 15:03:24 Cinnamon/kotaemon
2024-11-05 11:00:51 home-assistant/core
2024-11-04 23:11:11 DS4SD/docling
2024-11-04 10:56:18 open-compass/opencompass
2024-11-04 08:51:21 yt-dlp/yt-dlp
2024-11-02 04:45:40 princeton-vl/infinigen