Upsonic

Production-Ready AI Agent Framework with Safety First

Documentation • Quickstart • Examples • Discord

---

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

uv pip install upsonic
# pip install upsonic

Basic Agent

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

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

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

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)

---

GitHub에서 전체 내용 보기