Skip to content
Upsonic logo

Upsonic

Verified

Python framework for building autonomous and traditional AI agents.

Autonomous AgentsAgent Frameworks 7.9kOpen source
View on GitHub
Updated 2026-06-15
Upsonic GitHub repository

What is Upsonic?

Upsonic is an open-source Python library designed to help users construct AI agents that operate independently or follow structured instructions. It provides classes for autonomous execution with safety boundaries and standard agents that process tasks using specified models.

The framework manages agent behavior through task definitions, optional custom tools, and restricted environments that limit file and command access. Prebuilt agent options and OCR capabilities for text extraction from documents extend its functionality for varied applications.

It targets Python developers seeking to prototype or deploy agent systems, particularly those working with language models for analysis, automation, or data handling tasks.

Capabilities

support mcp
enable trusted agent workflows
add verification layers
provide reliable agent execution

What you can build with Upsonic

Log Analysis

Set up an autonomous agent to scan server logs within a defined workspace and identify unusual patterns without risking broader system access.

Market Review

Deploy a traditional agent to evaluate current market trends and generate insights using a chosen language model.

Document Text Extraction

Apply the OCR module with supported engines to convert PDF files into readable text through a layered processing approach.

Install Upsonic

Install
uv pip install upsonic
Quick start
uv pip install upsonic
# pip install upsonic
  1. 1Install the package using uv pip install upsonic or the standard pip command.
  2. 2Import AutonomousAgent or Agent along with Task from the upsonic module.
  3. 3Initialize the agent with a model string and optional workspace path for safety limits.
  4. 4Define a task with a description and any custom tools if needed.
  5. 5Run the task via the print_do method to execute and view results.

Works with

MCP

Upsonic: pros & cons

Pros

  • +Clear separation between autonomous and standard agent modes.
  • +Built-in workspace restrictions to contain operations.
  • +Support for multiple OCR engines in one interface.
  • +Option to use community prebuilt agents for quick starts.

Cons

  • Requires Python and familiarity with its ecosystem.
  • Autonomous features depend on external model providers.
  • OCR setup needs additional installation for full engine support.
Did you find this helpful?

Frequently asked questions

It works with various providers through model strings such as anthropic/claude-sonnet-4-5.

User reviews

Verified reviews from the community shape this listing's rating.

Loading reviews…

Sign in to review

Promote Upsonic

Add this badge to your website, or share the tool.

DFeatured on DhanasviUpsonic 0