Usage#
This guide covers common usage patterns and examples for gptme.
To start a new chat or select an existing one, run:
gptme
This will show you a list of past chats, allowing you to select one or start a new one.
To get inspiration for your first prompt, see the Examples.
Features#
Tools
gptme comes with a variety of tools for different tasks:
Shell - Execute shell commands
Python - Run Python code
Browser - Browse and interact with web content
Vision - Process and analyze images
See the Tools page for a complete list of available tools.
Writing Files
You can ask the assistant to create new files or modify existing ones:
User |
create a new file named life.py implementing the game of life |
Assistant |
Certainly! I'll create a new file named `life.py` implementing Conway's Game of Life. This implementation will use NumPy for efficient array operations and Matplotlib for visualization. Here's the code: |
System |
Saved to life.py |
Making Changes
You can start chats and request changes directly from the command line. The contents of any mentioned text files will be included as context, and the assistant will generate patches to apply the requested changes:
gptme 'make improvements to life.py so that dead cells fade out over time'
User |
make improvements to life.py so that dead cells fade out over time |
Assistant |
To make alive cells green and dead cells black in the Game of Life simulation, we need to modify the colormap and how we represent the cell states. Here's the updated `life.py` script with these changes: |
System |
Patch applied |
Browser Integration
With the Browser extras installed, the assistant can process URLs included in the prompt and interact with web content.
Commands#
During a chat session, you can use these slash-commands for various actions:
/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/summarize
- Summarize the conversation/replay
- Re-execute codeblocks in the conversation/help
- Show help message/exit
- Exit the program
Interfaces#
Besides the CLI, gptme can be used through:
Web UI - A web-based interface
GitHub Bot - GitHub bot integration
For more detailed information about specific features, check out: