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