gptme  by gptme

CLI tool for terminal agent workflows

created 2 years ago
3,940 stars

Top 12.6% on sourcepulse

GitHubView on GitHub
Project Summary

gptme provides a personal AI agent within the terminal, designed for knowledge workers and developers. It offers an unconstrained, local alternative to cloud-based AI assistants by integrating tools for code execution, file manipulation, web browsing, and vision capabilities, all while prioritizing privacy and user control.

How It Works

gptme operates as a powerful CLI application that leverages various tools to extend the capabilities of Large Language Models (LLMs). It allows LLMs to interact with the local environment by executing shell commands, running Python code, reading/writing files, and browsing the web via Playwright. A key feature is its self-correcting mechanism, where the LLM's output is fed back into the system, enabling it to refine its actions. It supports multiple LLM providers, including local models served via llama.cpp, and offers a built-in web UI and REST API for broader accessibility.

Quick Start & Requirements

Highlighted Details

  • Supports local LLM execution for enhanced privacy.
  • Integrates with tools like Playwright for web browsing and vision capabilities.
  • Offers a self-hostable web UI and REST API.
  • Features a self-correcting mechanism for improved AI performance.
  • Extensible via a tool-based architecture.

Maintenance & Community

  • Active development with a clean, well-tested codebase.
  • Links to Discord are available.

Licensing & Compatibility

  • The project appears to be licensed under the MIT License, allowing for broad commercial use and integration.

Limitations & Caveats

  • Demo videos are noted as out-of-date.
  • Advanced features like long-running agents and RAG are still in progress.
Health Check
Last commit

6 days ago

Responsiveness

1 day

Pull Requests (30d)
16
Issues (30d)
17
Star History
206 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.