LibreAI / AI Agents / Upsonic
// agents · Upsonic/Upsonic

Upsonic

Upsonic — build autonomous AI agents in Python, with prebuilt agents, custom tools, MCP and OCR built in.

★ 8.0k stars⑂ 748 forksMITupdated 2026-06
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

Upsonic is an open-source ai agents project by Upsonic (Upsonic/Upsonic on GitHub). It has 7,955 GitHub stars and 748 forks, is released under the MIT license, and was last updated on GitHub on 18 June 2026.

Repository
Upsonic/Upsonic
GitHub stars
7,955
Forks
748
License
MIT
Last updated on GitHub
18 June 2026
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide whether a prebuilt agent covers your task or you need a custom agent with your own tools, and which LLM it will use.

  2. Get the project

    Clone Upsonic/Upsonic from GitHub (or use the install path in the run steps below) and skim its README for the parts relevant to your goal.

  3. Install and configure

    Install upsonic with uv or pip, adding the OCR extra if your agent must process documents.

  4. Run your first task

    Create a minimal autonomous agent from the quickstart, give it one tool and one real task, and check its output before adding complexity.

// features

Why people love it

Autonomous agent framework

Build agents designed to work autonomously in Python, not just single prompt-response calls.

Prebuilt agents

Start from the project's ready-made agents and customise them, instead of building every agent from zero.

Custom tools

Add your own tools to an agent so it can act on your systems and data.

OCR and document processing

Built-in OCR/document capabilities (via the upsonic[ocr] extra) for agents that must read documents.

MCP support

Connects to Model Context Protocol tooling, so external MCP servers can extend your agents.

IDE integration

Documented IDE integration to develop and work with agents inside your editor workflow.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source from the official GitHub repository for Upsonic.

    git clone https://github.com/Upsonic/Upsonic.git
    cd Upsonic
  2. Install Upsonic

    Install the package with uv as the README's quick start shows (pip works too).

    uv pip install upsonic
  3. Create your first agent

    Follow the README/docs quickstart pattern to create an autonomous agent and run a task.

    # In Python: create an Upsonic agent per the quickstart at docs.upsonic.ai, then run your task — see README
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains Upsonic?

Upsonic, through the Upsonic/Upsonic repository, with documentation at docs.upsonic.ai.

Is Upsonic free to use?

Yes — the project is open source under the MIT license as recorded for this listing. You can use, modify and distribute it under the MIT terms.

Does Upsonic need a paid API key?

Agents need an LLM you configure — typically your own provider API key, billed by the provider; the framework itself is free and MIT licensed.

How does Upsonic compare to a general multi-agent framework?

Upsonic focuses on building dependable single and autonomous agents in Python, with prebuilt agents, tools and OCR included. Broader multi-agent frameworks emphasise orchestrating many role-playing agents; Upsonic's pitch is a tighter, production-minded agent toolkit.

How do I get started with Upsonic?

Clone the repository (or use the documented installer), follow the install and configure steps on this page, and run the smallest real task first — create a minimal autonomous agent from the quickstart, give it one tool and one real task, and check its output before adding complexity.

// keep exploring

Similar tools

AI Agents

kuberna-labs

Build, deploy, and monetize autonomous agents across Web3.

★ 51 starsMIT
View guide →
AI Agents

beeai-framework

Build production-ready AI agents in both Python and Typescript.

★ 3.4k starsApache-2.0
View guide →
Agents

yu-ai-agent

Chinese Java course: build AI agents with Spring AI, RAG, MCP, and tool calling.

★ 2.7k starsCustom
View guide →
AI Agents

MobileBuildMCP

An MCP server and CLI that lets AI agents build, test and run iOS and macOS projects.

★ 6.5k starsMIT
View guide →
AI Agents

agent-device

Mobile app automation and verification built for AI coding agents — CLI, MCP server, and Node API

★ 4.9k starsMIT
View guide →
AI Agents

fast-agent

Code, build and evaluate LLM agents with full MCP, Skills, ACP and A2A support.

★ 3.9k starsApache-2.0
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if Upsonic is not the right fit.

Get Upsonic

Free and open — grab the source, star the repo, and start creating.