This release is a pre-release and may not be stable for production use.
Overview
Upsonic is a Python framework for building autonomous agents like OpenClaw and Claude Cowork, as well as more traditional agent systems.
Quick Start
Installation
uv pip install upsonic
# pip install upsonic
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.
Create Autonomous Agent
Build Your Own
from upsonic import AutonomousAgent, Task
agent = AutonomousAgent(
model="anthropic/claude-sonnet-4-5",
workspace="/path/to/logs"
)
task = Task("Analyze server logs and detect anomaly patterns")
agent.print_do(task)
All file and shell operations are restricted to workspace. Path traversal and dangerous commands are blocked.
Use Our Prebuilt Ones
Prebuilt autonomous agents are ready-to-run agents built by the Upsonic community, each packaging a skill, system prompt, and first message so you can go from install to running in seconds. The collection is open to contributions, bring your agent and open a PR.
Learn more: Prebuilt Autonomous Agents
Next steps: Connect a Sandbox Provider (E2B) for isolated cloud execution environments.
Create Traditional 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)
Add Custom Tools
from upsonic import Agent, Task
from upsonic.tools import tool
@tool
def sum_tool(a: float, b: float) -> float:
"""
Add two numbers together.
Args:
a: First number
b: Second number
Returns:
The sum of a and b
"""
return a + b
task = Task(
description="Calculate 15 + 27",
tools=[sum_tool]
)
agent = Agent(model="anthropic/claude-sonnet-4-5", name="Calculator Agent")
result = agent.print_do(task)
Next steps: Integrate MCP Tools to connect your agents to thousands of external data sources and services.
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.
uv pip install "upsonic[ocr]"
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
Check Our Videos
|
|
Documentation and Resources
- Documentation - Complete guides and API reference
- Quickstart Guide - Get started in 5 minutes
- Examples - Real-world examples and use cases
- API Reference - Detailed API documentation
Community and Support
💬 Join our Discord community! — Ask questions, share what you're building, get help from the team, and connect with other developers using Upsonic.
- Discord - Chat with the community and get real-time support
- Issue Tracker - Report bugs and request features
- Changelog - See what's new in each release
License
Upsonic is released under the MIT License. See LICENCE for details.
Contributing
We welcome contributions from the community! Please read our Contributing Guide and code of conduct before submitting pull requests.
1 maintainer
Release files for upsonic 0.76.3a1778839241
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| upsonic-0.76.3a1778839241.tar.gz | 3.4 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| upsonic-0.76.3a1778839241-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 5.1 MB
Release files / upsonic-0.76.3a1778839241.tar.gz
| Download URL | upsonic-0.76.3a1778839241.tar.gz |
|---|---|
| Size | 3.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0e524588cbc77c06b5552f206b85119a7e95303c65222194e9dac98c0ad65a8a
|
|
BLAKE2b-256 checksum How to use checksums |
d09cde584e4e92dffabdc1c83b3059eb37cb7537dac12ff403af7fd12471efa9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / upsonic-0.76.3a1778839241-py3-none-any.whl
| Download URL | upsonic-0.76.3a1778839241-py3-none-any.whl |
|---|---|
| Size | 1.7 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a79851ad5e1e859909248362ef346ba549e8779f4426257c17295417f071fc5d
|
|
BLAKE2b-256 checksum How to use checksums |
583db68acbd13726af627da1cc482e772202c148520cec5945a43b1a97b8e4fe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
