
Upsonic
Python framework for building autonomous and traditional AI agents
- Pricing
- Open source
- Platforms
- API, CLI, self-hosted
- GitHub stars
- 8K
- Last commit
- 5 months ago
- Language
- Python
- License
- MIT
About Upsonic
Upsonic is an open-source agent framework for multi-agent frameworks. It is available on API, CLI and self-hosted.
Upsonic offers two ways to write an agent. An AutonomousAgent is pointed at a workspace folder and a task, with file and shell operations restricted to that workspace and path traversal and dangerous commands blocked. A traditional Agent takes a Task plus tools you define with a decorator, which suits predictable, tool-driven jobs.
Around that sit building blocks for memory, a RAG knowledge base, teams of agents, skills, human-in-the-loop approval, tracing and a safety engine. It also includes an OCR layer with engines such as EasyOCR, RapidOCR and Tesseract for document processing, and a set of community prebuilt autonomous agents.
Models are addressed by provider and name, with OpenAI, Anthropic and local Ollama endpoints shown in the setup. Docs can be added to Cursor-style coding tools through an llms-full.txt file.
What it does
- Autonomous agents
- Run an agent against a restricted workspace.
- Traditional agents
- Define tools with a decorator and run tasks.
- Memory and RAG
- Add memory and a knowledge base.
- Multi-agent teams
- Combine agents into teams.
- Human in the loop
- Pause for human approval on actions.
- OCR pipeline
- Extract text from documents with several OCR engines.
- Tracing and safety
- Trace runs and apply a safety engine.
Good for
- Build an agent that analyses server logs
- Add document OCR to an agent pipeline
- Compose teams of agents
- Add approval steps before tools run
A2A skills
upsonic
Use when building AI agents (autonomous or traditional), creating
Agent card: https://docs.upsonic.ai/.well-known/agent-card.json
Pricing
Open source
MIT licensed
Prices change. Check docs.upsonic.ai before you buy.
Upsonic FAQ
How do I install it?
With pip or uv: install the upsonic package.
Which models can it use?
The setup shows OpenAI and Anthropic keys and an Ollama base URL.
Is it restricted in what files it can touch?
For autonomous agents, file and shell operations are limited to the workspace you set.
Licence?
MIT.
Is Upsonic free?
Yes. Upsonic is open source, so you can use and self-host it for free.
What are the best alternatives to Upsonic?
The closest alternatives to Upsonic are hermes-agent, deepseek-harness, langchain, gemini-cli and deer-flow.
Alternatives to Upsonic

hermes-agent
AgentOpen-source self-improving agent with memory, scheduling and many chat gateways
- Freemium
- Open-source agent
- 264K GitHub stars
- AI models and LLM tooling

deepseek-harness
AgentOpen-source agent harness from DeepSeek, built on a plugin architecture
- Open source
- Open-source agent
- 282K GitHub stars
- Multi-agent frameworks

langchain
AgentPython library for building agents from a model, tools, prompt and middleware
- Open source
- Agent framework
- 150K GitHub stars
- AI models and LLM tooling

gemini-cli
AgentOpen-source terminal agent for Gemini Code Assist workflows on Google Cloud
- Open source
- Open-source agent
- 109K GitHub stars
- AI models and LLM tooling

deer-flow
AgentOpen-source super agent harness that researches, codes and creates with sandboxes
- Open source
- Open-source agent
- 85.4K GitHub stars
- AI models and LLM tooling

ruflo
AgentAgent meta-harness that adds swarms, memory and MCP tools to Claude Code and Codex
- Open source
- Agent framework
- 81.9K GitHub stars
- Knowledge and memory