Skip to main content
ClaudeWave
EN, English
Upsonic / Subagents

Upsonic

Build autonomous AI agents in Python.

  • 8k stars
  • 745 forks
  • 37 open issues
  • Language: Python
  • License: MIT
  • updated

Install

Terminal
git clone https://github.com/Upsonic/Upsonic && cp Upsonic/*.md ~/.claude/agents/
  1. Clone the repository and copy the agent .md definitions into ~/.claude/agents (or .claude/agents inside a project).
  2. Start a new Claude Code session to load the agents.
  3. Delegate work to them with the Task/Agent tool or by name.

Editor's note

Upsonic is a Python framework for constructing autonomous and traditional AI agents using Claude (via the Anthropic API, specifically models like claude-sonnet-4-5) alongside other LLMs. The framework offers two primary agent classes: `AutonomousAgent`, which restricts all file and shell operations to a declared workspace directory and blocks path traversal and dangerous commands, and `Agent`, a more conventional task-runner that accepts custom Python functions decorated with `@tool`. Both classes connect to external services through MCP tool integration, giving agents access to third-party data sources and APIs. The repository also ships prebuilt community agents such as OpenClaw and Claude Cowork, each bundled with a system prompt and first message for immediate use. A separate OCR module supports a layered document processing pipeline with six interchangeable engines including EasyOCR, Tesseract, PaddleOCR, and DeepSeek OCR. Python developers building production agent workflows, document extraction pipelines, or multi-tool automation systems are the primary audience.

Installable items

11 items in this repository

Install
Install

Perform structured code reviews with actionable feedback. Use when a user asks to review code, check code quality, find bugs, audit security, improve performance, or assess maintainability. Trigger when user says things like "review this code", "check for bugs", "is this code secure", "any issues with this", "code quality check", or pastes code asking for feedback. Also trigger for pull request reviews and pre-merge code checks. Do NOT trigger for writing new code from scratch, refactoring requests without review context, or general programming questions.

Install

Analyze, explore, clean, and visualize datasets with statistical rigor. Use when user asks to analyze data, find patterns, compute statistics, create visualizations, clean messy data, or explore a dataset. Trigger when user says things like "analyze this data", "what trends do you see", "find patterns in", "create a chart", "clean this dataset", "run statistics on", "what does this data tell us", or provides CSV/Excel/JSON data for exploration. Also trigger for A/B test analysis, cohort analysis, and data quality assessments. Do NOT trigger for simple data format conversions, database query writing without analysis, or ETL pipeline design.

Install
Install
Install
Install
Install

Summarize documents, articles, conversations, code, and technical content into concise, accurate summaries. Use when user asks to summarize, condense, create a TL;DR, write an executive summary, extract key points, or distill content. Trigger when user says things like "summarize this", "give me the key points", "TL;DR", "what are the main takeaways", "condense this", "brief me on this", or provides long content asking for a shorter version. Also trigger for meeting notes summaries, research paper abstracts, and changelog summaries. Do NOT trigger for rewriting or paraphrasing at similar length, translation, or content generation from scratch.

Install

Use this agent when you need to create unit tests for your code in unittest.TestCase format, organized in a tests folder with concept-based subfolders. Examples: <example>Context: User has just written a new authentication module and needs comprehensive unit tests. user: 'I just finished writing my user authentication functions in auth.py. Can you help me create unit tests for them?' assistant: 'I'll use the unittest-generator agent to create comprehensive unit tests for your authentication module.' <commentary>Since the user needs unit tests created for their authentication code, use the unittest-generator agent to create properly structured tests in the tests folder with appropriate subfolder organization.</commentary></example> <example>Context: User has implemented new data validation functions and wants to ensure they're properly tested. user: 'I've added several validation functions to my utils.py file. I need unit tests to make sure they handle edge cases correctly.' assistant: 'Let me use the unittest-generator agent to create thorough unit tests for your validation functions.' <commentary>The user needs unit tests for their validation functions, so use the unittest-generator agent to create comprehensive tests with edge case coverage.</commentary></example>

Install
README

Subagents overview

README preview not available. Visit the repo on GitHub for full documentation.
Use cases
Topics
agentagent-frameworkautonomous-agentautonomous-agentsclaudecomputer-usellmsmcpmodel-context-protocolopenaiopenclawragreliabilityucpuniversal-commerce-protocol
Frequently asked

What people ask about Upsonic

What is Upsonic/Upsonic?

Upsonic/Upsonic is subagents for the Claude AI ecosystem. Build autonomous AI agents in Python. It has 8k GitHub stars and its last recorded update is dated 2026-06-18.

How do I install Upsonic?

You can install Upsonic by cloning the repository (https://github.com/Upsonic/Upsonic) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.

Is Upsonic/Upsonic safe to use?

Our security agent has analyzed Upsonic/Upsonic and assigned a Trust Score of 92/100 (tier: Verified). See the full breakdown of passed checks and flags on this page.

Who maintains Upsonic/Upsonic?

Upsonic/Upsonic is maintained by Upsonic. The last recorded GitHub activity is dated 2026-06-18, with 37 open issues.

Are there alternatives to Upsonic?

Yes. On ClaudeWave you can browse similar subagents at /categories/agents, sorted by popularity or recent activity.

Project homepage
https://docs.upsonic.ai