https://github.com/upsonic/upsonic
The most reliable AI agent framework that supports MCP.
https://github.com/upsonic/upsonic
agent agent-framework claude computer-use llms mcp model-context-protocol openai rag reliability
Last synced: 8 days ago
JSON representation
The most reliable AI agent framework that supports MCP.
- Host: GitHub
- URL: https://github.com/upsonic/upsonic
- Owner: Upsonic
- License: mit
- Created: 2024-05-26T16:23:38.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2025-05-01T17:11:21.000Z (12 months ago)
- Last Synced: 2025-05-01T17:49:53.512Z (12 months ago)
- Topics: agent, agent-framework, claude, computer-use, llms, mcp, model-context-protocol, openai, rag, reliability
- Language: Python
- Homepage: https://docs.upsonic.ai
- Size: 4.01 MB
- Stars: 7,398
- Watchers: 56
- Forks: 689
- Open Issues: 44
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- acu - Upsonic
- awesome-agents - Upsonic
- awesome-ChatGPT-repositories - Upsonic - We do NOT and WILL not have any Crypto Projects, they are a complete SCAM | Task oriented AI agent framework for digital workers and vertical AI agents (Chatbots)
- Awesome-AI-Agents - Upsonic - Upsonic is a reliable agent framework supporting MCP, offering trusted agent workflows with verification layers.  (Frameworks / Advanced Components)
- awesome-llm-agents - Upsonic - Reliable agent framework that (Frameworks)
- awesome-ai-agents-2026 - Upsonic
- awesome-ai-agents - Upsonic - oriented | (🌟 Core Frameworks)
- awesome_ai_agents - Upsonic - Reliable agent framework that supports MCP. [github](https://github.com/upsonic/upsonic) (Building / Frameworks)
README
# Upsonic
**Production-Ready AI Agent Framework with Safety First**
[](https://badge.fury.io/py/upsonic)
[](LICENCE)
[](https://pypi.org/project/upsonic/)
[](https://github.com/Upsonic/Upsonic)
[](https://github.com/Upsonic/Upsonic/issues)
[](https://docs.upsonic.ai)
[](https://discord.gg/pmYDMSQHqY)
[Documentation](https://docs.upsonic.ai) • [Quickstart](https://docs.upsonic.ai/get-started/quickstart) • [Examples](https://docs.upsonic.ai/examples) • [Discord](https://discord.gg/pmYDMSQHqY)
---
## Overview
Upsonic is an open-source AI agent framework for building production-ready agents. It supports multiple AI providers (OpenAI, Anthropic, Azure, Bedrock) and includes built-in safety policies, OCR, memory, multi-agent coordination, and MCP tool integration.
## What Can You Build?
- **Document Analysis**: Extract and process text from images and PDFs
- **Customer Service Automation**: Agents with memory and session context
- **Financial Analysis**: Agents that analyze data, generate reports, and provide insights
- **Compliance Monitoring**: Enforce safety policies across all agent interactions
- **Research & Data Gathering**: Automate research workflows with multi-agent collaboration
- **Multi-Agent Workflows**: Orchestrate tasks across specialized agent teams
## Quick Start
### Installation
```bash
uv pip install upsonic
# pip install upsonic
```
### Basic Agent
```python
from upsonic import Agent, Task
agent = Agent(model="anthropic/claude-sonnet-4-5", name="Stock Analyst Agent")
task = Task(description="Analyze the current market trends")
agent.print_do(task)
```
### Agent with Tools
```python
from upsonic import Agent, Task
from upsonic.tools.common_tools import YFinanceTools
agent = Agent(model="anthropic/claude-sonnet-4-5", name="Stock Analyst Agent")
task = Task(
description="Give me a summary about tesla stock with tesla car models",
tools=[YFinanceTools()]
)
agent.print_do(task)
```
### Agent with Memory
```python
from upsonic import Agent, Task
from upsonic.storage import Memory, InMemoryStorage
memory = Memory(
storage=InMemoryStorage(),
session_id="session_001",
full_session_memory=True
)
agent = Agent(model="anthropic/claude-sonnet-4-5", memory=memory)
task1 = Task(description="My name is John")
agent.print_do(task1)
task2 = Task(description="What is my name?")
agent.print_do(task2) # Agent remembers: "Your name is John"
```
**Ready for more?** Check out the [Quickstart Guide](https://docs.upsonic.ai/get-started/quickstart) for additional examples including Knowledge Base and Team workflows.
## Key Features
- **Autonomous Agent**: An agent that can read, write, and execute code inside a sandboxed workspace, no tool setup required
- **Safety Engine**: Policy-based content filtering applied to user inputs, agent outputs, and tool interactions
- **OCR Support**: Unified interface for multiple OCR engines with PDF and image support
- **Memory Management**: Session memory and long-term storage with multiple backend options
- **Multi-Agent Teams**: Sequential and parallel agent coordination
- **Tool Integration**: MCP tools, custom tools, and human-in-the-loop workflows
- **Production Ready**: Monitoring, metrics, and enterprise deployment support
## Core Capabilities
### Autonomous Agent
`AutonomousAgent` extends `Agent` with built-in filesystem and shell tools, automatic session memory, and workspace sandboxing. Useful for coding assistants, DevOps automation, and any task that needs direct file or terminal access.
```python
from upsonic import AutonomousAgent, Task
agent = AutonomousAgent(
model="anthropic/claude-sonnet-4-5",
workspace="/path/to/project"
)
task = Task("Read the main.py file and add error handling to every function")
agent.print_do(task)
```
All file and shell operations are restricted to `workspace`. Path traversal and dangerous commands are blocked.
---
### Safety Engine
The Safety Engine applies policies at three points: user inputs, agent outputs, and tool interactions. Policies can block, anonymize, replace, or raise exceptions on matched content.
```python
from upsonic import Agent, Task
from upsonic.safety_engine.policies.pii_policies import PIIAnonymizePolicy
agent = Agent(
model="anthropic/claude-sonnet-4-5",
user_policy=PIIAnonymizePolicy, # anonymizes PII before sending to the LLM
)
task = Task(
description="My email is john.doe@example.com and phone is 555-1234. What are my email and phone?"
)
# PII is anonymized before reaching the LLM, then de-anonymized in the response
result = agent.do(task)
print(result) # "Your email is john.doe@example.com and phone is 555-1234"
```
Pre-built policies cover PII, adult content, profanity, financial data, and more. Custom policies are also supported.
Learn more: [Safety Engine Documentation](https://docs.upsonic.ai/concepts/safety-engine/overview)
---
### OCR and Document Processing
Upsonic provides a unified OCR interface with a layered pipeline: Layer 0 handles document preparation (PDF to image conversion, preprocessing), Layer 1 runs the OCR engine.
```bash
uv pip install "upsonic[ocr]"
```
```python
from upsonic.ocr import OCR
from upsonic.ocr.layer_1.engines import EasyOCREngine
engine = EasyOCREngine(languages=["en"])
ocr = OCR(layer_1_ocr_engine=engine)
text = ocr.get_text("invoice.pdf")
print(text)
```
Supported engines: EasyOCR, RapidOCR, Tesseract, PaddleOCR, DeepSeek OCR, DeepSeek via Ollama.
Learn more: [OCR Documentation](https://docs.upsonic.ai/concepts/ocr/overview)
## Upsonic AgentOS
AgentOS is an optional deployment platform for running agents in production. It provides a Kubernetes-based runtime, metrics dashboard, and self-hosted deployment.
- **Kubernetes-based FastAPI Runtime**: Deploy agents as isolated, scalable microservices
- **Metrics Dashboard**: Track LLM costs, token usage, and performance per transaction
- **Self-Hosted**: Full control over your data and infrastructure
- **One-Click Deployment**: Automated deployment pipelines
## IDE Integration
Add Upsonic docs as a source in your coding tools:
**Cursor:** Settings → Indexing & Docs → Add `https://docs.upsonic.ai/llms-full.txt`
Also works with VSCode, Windsurf, and similar tools.
## Documentation and Resources
- **[Documentation](https://docs.upsonic.ai)** - Complete guides and API reference
- **[Quickstart Guide](https://docs.upsonic.ai/get-started/quickstart)** - Get started in 5 minutes
- **[Examples](https://docs.upsonic.ai/examples)** - Real-world examples and use cases
- **[API Reference](https://docs.upsonic.ai/reference)** - Detailed API documentation
## Community and Support
> **💬 [Join our Discord community!](https://discord.gg/pmYDMSQHqY)** — Ask questions, share what you're building, get help from the team, and connect with other developers using Upsonic.
- **[Discord](https://discord.gg/pmYDMSQHqY)** - Chat with the community and get real-time support
- **[Issue Tracker](https://github.com/Upsonic/Upsonic/issues)** - Report bugs and request features
- **[Changelog](https://docs.upsonic.ai/changelog)** - See what's new in each release
## License
Upsonic is released under the MIT License. See [LICENCE](LICENCE) for details.
## Contributing
We welcome contributions from the community! Please read our contributing guidelines and code of conduct before submitting pull requests.
---
**Learn more at [upsonic.ai](https://upsonic.ai)**