fast-agent
A terminal agent and Python framework with MCP, SKILL.md and ACP support for coding, building and evaluating your own agents
Install
uv tool install -U fast-agent-mcpThen run: fast-agent --model opus -xx
This is third-party code. Review the repository files before installing.
What it does
fast-agent runs in the terminal as a coding agent with shell access and built-in subagents. The /skills command adds skills from its registry, and /connect attaches MCP servers over stdio or streamable HTTP with OAuth. As a framework it lets you declare agents and workflows in Python and test them. It supports Anthropic, OpenAI and Google models, local models via llama.cpp and Ollama, and any setup can be served to an ACP client.
Who it is for. For developers who build their own MCP-based agents or want an open terminal agent with a free choice of model.
Good fit when
- You need to build and test an MCP agent or workflow quickly
- You want a terminal agent that works with many providers and local models
- You need to debug an MCP server, including streamable HTTP transport and elicitations
Not a fit when
- You are happy with Claude Code or Codex and do not write your own agents
- You need a ready-made skill rather than an agent runtime
Example request
Connect the huggingface MCP server and find speech recognition models for RussianLimitations
Requires uv and Python. Cloud models need provider keys; the OpenAI and Anthropic APIs are not reachable from Russia without a VPN, while local models work offline. Shell mode runs commands on your machine.
How to disable. Remove the tool with uv tool uninstall fast-agent-mcp.
Security check
- In shell mode the agent runs arbitrary commands
- Sends data to the chosen model provider
README in short
The README suggests starting with uvx fast-agent-mcp@latest -x or installing via uv tool install. It covers packs for Hugging Face Inference Providers and the Codex plan, attaching MCP servers and managing skills. It highlights full MCP feature support, including sampling, elicitations and transport diagnostics. Docs live at fast-agent.ai and in the docs folder. Apache-2.0 licensed.
FAQ
Can I try it without installing?
Yes, uvx fast-agent-mcp@latest -x starts an interactive shell session without installation.
Does it work with local models?
Yes, there is a generic provider for local models, and fast-agent model llamacpp writes the llama.cpp config for you.
Related
Open-source personal AI assistant on your own machine: answers in Telegram, Slack, Discord and WhatsApp, extended with skills and plugins
A self-improving agent from Nous Research with a TUI, messaging gateway, cron jobs and skills it writes itself
An open source coding agent for the terminal and desktop with build and plan modes
Open prompt library with a Claude Code plugin, MCP server and CLI: search, fetch and improve prompts and skills from an agent