# Upsonic

> Upsonic is an open-source agent framework for multi-agent frameworks. Python framework for building autonomous and traditional AI agents. It is available on API, CLI and self-hosted.

- **Kind:** Agent
- **Pricing:** Open source
- **Platforms:** API, CLI, self-hosted
- **Website:** https://docs.upsonic.ai
- **Repository:** https://github.com/upsonic/upsonic
- **GitHub stars:** 7,971
- **License:** MIT
- **Categories:** multi-agent frameworks, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## 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

- [hermes-agent](https://ai-powered.com/agents/hermes-agent): hermes-agent is a freemium open-source agent for ai models and llm tooling.
- [deepseek-harness](https://ai-powered.com/agents/deepseek-harness): deepseek-harness is an open-source agent for multi-agent frameworks.
- [langchain](https://ai-powered.com/agents/langchain): langchain is an open-source agent framework for ai models and llm tooling.
- [gemini-cli](https://ai-powered.com/agents/gemini-cli): gemini-cli is an open-source agent for ai models and llm tooling.
- [deer-flow](https://ai-powered.com/agents/deer-flow): deer-flow is an open-source agent for ai models and llm tooling.
- [ruflo](https://ai-powered.com/agents/ruflo-2): ruflo is an open-source agent framework for knowledge and memory.
- [learn-claude-code](https://ai-powered.com/agents/learn-claude-code): learn-claude-code is an open-source hosted agent for ai models and llm tooling.
- [autogen](https://ai-powered.com/agents/autogen): autogen is an open-source agent framework for multi-agent frameworks.

---
Source: https://ai-powered.com/agents/upsonic
