Upsonic/Upsonic

Build autonomous AI agents in Python.

What it solves

Upsonic 是一個 Python 框架，旨在簡化自主 AI 代理與傳統代理系統的建立。它提供結構化的方式來建構能執行複雜任務、與檔案與 Shell 互動、以及透過 OCR 處理文件的代理，同時維持安全邊界。

How it works

Upsonic 提供兩種主要的代理類型：

  • Autonomous Agents：這些代理在受限的 workspace 內執行檔案與 Shell 操作，以防止路徑穿越與危險指令。它們可透過連接 E2B 等 Sandbox Provider 進一步加強，實現隔離的雲端執行。
  • Traditional Agents：這些代理專注於使用自訂工具（透過 @tool 裝飾器定義）或外部 MCP Tools 連接各種資料來源與服務來執行任務。

此外，框架還包含統一的 OCR 介面，具備分層管線（第 0 層負責前置處理，第 1 層為 OCR 引擎），支援多種引擎，如 EasyOCR、Tesseract 與 DeepSeek OCR。

Who it’s for

想要建立能自主行動、使用工具或處理文件的 AI 代理，而不必從頭構建底層基礎設施的 Python 開發者。

Highlights

  • Autonomous Execution：內建檔案與 Shell 操作限制，確保安全。
  • Prebuilt Agents：社群驅動的即用型代理集合，內含預先封裝的技能與提示。
  • Extensible Tooling：支援自訂 Python 工具與 MCP Tools 進行外部整合。
  • Unified OCR：分層管線支援多種 OCR 引擎（例如 EasyOCR、RapidOCR、PaddleOCR）。
  • IDE Integration：直接為 Cursor、VSCode 等工具提供文件索引。