Upsonic

Production-Ready AI Agent Framework with Safety First

](https://badge.fury.io/py/upsonic) [ ](https://pypi.org/project/upsonic/) [ ](https://github.com/Upsonic/Upsonic/issues) [ [](https://discord.gg/pmYDMSQHqY)

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