[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-72002":3},{"id":4,"name":5,"fullName":6,"owner":5,"repo":5,"description":7,"homepage":8,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":9,"rankLanguage":9,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":22,"hasPages":22,"topics":24,"createdAt":9,"pushedAt":9,"updatedAt":40,"readmeContent":41,"aiSummary":42,"trendingCount":15,"starSnapshotCount":15,"syncStatus":43,"lastSyncTime":44,"discoverSource":45},72002,"Upsonic","Upsonic\u002FUpsonic","Build autonomous AI agents in Python.","https:\u002F\u002Fdocs.upsonic.ai",null,"Python",7879,732,56,15,0,9,13,33,27,39.6,"MIT License",false,"master",[25,26,27,28,29,30,31,32,33,34,35,36,37,38,39],"agent","agent-framework","autonomous-agent","autonomous-agents","claude","computer-use","llms","mcp","model-context-protocol","openai","openclaw","rag","reliability","ucp","universal-commerce-protocol","2026-06-12 02:02:57","\u003Cdiv align=\"center\">\n\n\u003Cimg width=\"947\" alt=\"Upsonic_README\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Facb3f413-e4fe-44a6-9aff-40d4e9031188\" \u002F>\n\n# Upsonic\n\n**Build Autonomous AI Agents in Python**\n\n[![PyPI version](https:\u002F\u002Fbadge.fury.io\u002Fpy\u002Fupsonic.svg)](https:\u002F\u002Fbadge.fury.io\u002Fpy\u002Fupsonic)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-blue.svg)](LICENCE)\n[![Python Version](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fpyversions\u002Fupsonic.svg)](https:\u002F\u002Fpypi.org\u002Fproject\u002Fupsonic\u002F)\n[![GitHub stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FUpsonic\u002FUpsonic.svg?style=social&label=Star)](https:\u002F\u002Fgithub.com\u002FUpsonic\u002FUpsonic)\n[![GitHub issues](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002FUpsonic\u002FUpsonic.svg)](https:\u002F\u002Fgithub.com\u002FUpsonic\u002FUpsonic\u002Fissues)\n[![Documentation](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fdocs-upsonic.ai-brightgreen.svg)](https:\u002F\u002Fdocs.upsonic.ai)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join%20Community-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https:\u002F\u002Fdiscord.gg\u002FpmYDMSQHqY)\n\n[Documentation](https:\u002F\u002Fdocs.upsonic.ai) • [Quickstart](https:\u002F\u002Fdocs.upsonic.ai\u002Fget-started\u002Fquickstart) • [Examples](https:\u002F\u002Fdocs.upsonic.ai\u002Fexamples) • [Discord](https:\u002F\u002Fdiscord.gg\u002FpmYDMSQHqY)\n\n\u003C\u002Fdiv>\n\n---\n\n## Overview\n\nUpsonic is a Python framework for building autonomous agents like OpenClaw and Claude Cowork, as well as more traditional agent systems.\n\n## Quick Start\n\n### Installation\n\n```bash\nuv pip install upsonic\n# pip install upsonic\n```\n\n### IDE Integration\n\nAdd Upsonic docs as a source in your coding tools:\n\n**Cursor:** Settings → Indexing & Docs → Add `https:\u002F\u002Fdocs.upsonic.ai\u002Fllms-full.txt`\n\nAlso works with VSCode, Windsurf, and similar tools.\n\n---\n\n## Create Autonomous Agent\n\n### Build Your Own\n\n```python\nfrom upsonic import AutonomousAgent, Task\n\nagent = AutonomousAgent(\n    model=\"anthropic\u002Fclaude-sonnet-4-5\",\n    workspace=\"\u002Fpath\u002Fto\u002Flogs\"\n)\n\ntask = Task(\"Analyze server logs and detect anomaly patterns\")\n\nagent.print_do(task)\n```\n\nAll file and shell operations are restricted to `workspace`. Path traversal and dangerous commands are blocked.\n\n### Use Our Prebuilt Ones\n\nPrebuilt 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](https:\u002F\u002Fgithub.com\u002FUpsonic\u002FUpsonic\u002Ftree\u002Fmaster\u002Fsrc\u002Fupsonic\u002Fprebuilt), bring your agent and open a PR.\n\nLearn more: [Prebuilt Autonomous Agents](https:\u002F\u002Fdocs.upsonic.ai\u002Fconcepts\u002Fprebuilt-autonomous-agents\u002Foverview)\n\n> **Next steps:** Connect a [Sandbox Provider (E2B)](https:\u002F\u002Fdocs.upsonic.ai\u002Fconcepts\u002Fautonomous-agent\u002Foverview) for isolated cloud execution environments.\n\n---\n\n## Create Traditional Agent\n\n```python\nfrom upsonic import Agent, Task\n\nagent = Agent(model=\"anthropic\u002Fclaude-sonnet-4-5\", name=\"Stock Analyst Agent\")\n\ntask = Task(description=\"Analyze the current market trends\")\n\nagent.print_do(task)\n```\n\n### Add Custom Tools\n\n```python\nfrom upsonic import Agent, Task\nfrom upsonic.tools import tool\n\n@tool\ndef sum_tool(a: float, b: float) -> float:\n    \"\"\"\n    Add two numbers together.\n\n    Args:\n        a: First number\n        b: Second number\n\n    Returns:\n        The sum of a and b\n    \"\"\"\n    return a + b\n\ntask = Task(\n    description=\"Calculate 15 + 27\",\n    tools=[sum_tool]\n)\n\nagent = Agent(model=\"anthropic\u002Fclaude-sonnet-4-5\", name=\"Calculator Agent\")\n\nresult = agent.print_do(task)\n```\n\n> **Next steps:** Integrate [MCP Tools](https:\u002F\u002Fdocs.upsonic.ai\u002Fconcepts\u002Ftools\u002Fmcp-tools\u002Foverview) to connect your agents to thousands of external data sources and services.\n\n---\n\n## OCR and Document Processing\n\nUpsonic 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.\n\n```bash\nuv pip install \"upsonic[ocr]\"\n```\n\n```python\nfrom upsonic.ocr import OCR\nfrom upsonic.ocr.layer_1.engines import EasyOCREngine\n\nengine = EasyOCREngine(languages=[\"en\"])\nocr = OCR(layer_1_ocr_engine=engine)\n\ntext = ocr.get_text(\"invoice.pdf\")\nprint(text)\n```\n\nSupported engines: EasyOCR, RapidOCR, Tesseract, PaddleOCR, DeepSeek OCR, DeepSeek via Ollama.\n\nLearn more: [OCR Documentation](https:\u002F\u002Fdocs.upsonic.ai\u002Fconcepts\u002Focr\u002Foverview)\n\n---\n\n## Check Our Videos\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd align=\"center\">\n      \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=GOYko0KfBtg\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.youtube.com\u002Fvi\u002FGOYko0KfBtg\u002Fmaxresdefault.jpg\" width=\"400\" alt=\"Upsonic Demo Video 1\"\u002F>\n      \u003C\u002Fa>\n    \u003C\u002Ftd>\n    \u003Ctd align=\"center\">\n      \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=ulUEFIolesQ\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.youtube.com\u002Fvi\u002FulUEFIolesQ\u002Fmaxresdefault.jpg\" width=\"400\" alt=\"Upsonic Demo Video 2\"\u002F>\n      \u003C\u002Fa>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n---\n\n## Documentation and Resources\n\n- **[Documentation](https:\u002F\u002Fdocs.upsonic.ai)** - Complete guides and API reference\n- **[Quickstart Guide](https:\u002F\u002Fdocs.upsonic.ai\u002Fget-started\u002Fquickstart)** - Get started in 5 minutes\n- **[Examples](https:\u002F\u002Fdocs.upsonic.ai\u002Fexamples)** - Real-world examples and use cases\n- **[API Reference](https:\u002F\u002Fdocs.upsonic.ai\u002Freference)** - Detailed API documentation\n\n## Community and Support\n\n> **💬 [Join our Discord community!](https:\u002F\u002Fdiscord.gg\u002FpmYDMSQHqY)** — Ask questions, share what you're building, get help from the team, and connect with other developers using Upsonic.\n\n- **[Discord](https:\u002F\u002Fdiscord.gg\u002FpmYDMSQHqY)** - Chat with the community and get real-time support\n- **[Issue Tracker](https:\u002F\u002Fgithub.com\u002FUpsonic\u002FUpsonic\u002Fissues)** - Report bugs and request features\n- **[Changelog](https:\u002F\u002Fdocs.upsonic.ai\u002Fchangelog)** - See what's new in each release\n\n## License\n\nUpsonic is released under the MIT License. See [LICENCE](LICENCE) for details.\n\n## Contributing\n\nWe welcome contributions from the community! Please read our [Contributing Guide](CONTRIBUTING.md) and code of conduct before submitting pull requests.","Upsonic 是一个用于构建自主AI代理的Python框架。它支持创建如OpenClaw和Claude Cowork等先进代理，以及更传统的代理系统。核心功能包括使用预设或自定义模型快速搭建能够执行特定任务（例如分析日志文件以检测异常模式）的智能体，并通过限制工作空间内的操作来保证安全性。此外，项目还提供了一系列社区贡献的即用型代理，便于用户迅速上手。Upsonic适用于需要自动化处理复杂任务、数据分析及决策支持等多种场景，特别适合开发者希望通过集成AI能力提升应用智能化水平的情况。",2,"2026-06-11 03:39:53","high_star"]