Installation

Get started with Upsonic - Install, configure, and build your first AI Agent

Install Upsonic and start building AI agents in minutes.

Upsonic requires Python 3.10 or higher. Follow the steps below to install the framework and verify your installation.

Main Library

Install the core Upsonic framework to start building AI agents:

pip install upsonic

This installs the main framework with all essential features including agents, tasks, teams, memory, tools, and LLM integrations.

Python Version Requirements

Upsonic requires Python >=3.10. Here’s how to check your version:

python3 --version

If you need to update Python, visit python.org/downloads

Made with Love 💚

At Upsonic, we believe in giving developers choice and flexibility. That’s why we’ve built our framework with a layered architecture: you only install what you need, when you need it.

Want to build a simple agent? Just install the main library. Need RAG pipelines? Add the rag package. Building OCR workflows? Install ocr. Every feature is modular, every dependency is optional, and nothing bloats your project unnecessarily.

We designed Upsonic this way because we know your time, disk space, and deployment speed matter. No forced dependencies, no unnecessary packages. Just clean, efficient, developer-friendly architecture.

Because we build Upsonic with love, for developers who love to build. 💚

Optional Dependencies

Depending on your use case, you may need additional packages:

RAG

Install RAG dependencies for vector databases and knowledge base operations:

pip install "upsonic[rag]"

Use this when you need to build RAG pipelines with vector databases like Qdrant, ChromaDB, Pinecone, Weaviate, or FAISS.

Storage

Install storage backends for memory and state persistence:

pip install "upsonic[storage]"

Use this when you need databases like PostgreSQL, MongoDB, Redis, or SQLite for memory management.

Models

Install additional LLM provider integrations:

pip install "upsonic[models]"

Use this when you need providers like Anthropic, Google Gemini, Cohere, Groq, Mistral, or Azure OpenAI.

Embeddings

Install embedding model providers:

pip install "upsonic[embeddings]"

Use this when you need embedding models from OpenAI, Anthropic, Google, Azure, HuggingFace, or local FastEmbed.

Loaders

Install loaders to work with various file formats in your knowledge base:

pip install "upsonic[loaders]"

Use this when you need to process PDF, DOCX, CSV, Markdown, YAML, HTML, or other document formats.

Tools

Install pre-built tools for web search and data retrieval:

pip install "upsonic[tools]"

Use this when you need tools like DuckDuckGo search, Tavily, Yahoo Finance, or web scraping capabilities.

OCR

Install OCR capabilities to extract text from images and scanned documents:

pip install "upsonic[ocr]"

Use this when you need OCR providers like EasyOCR, PaddleOCR, Tesseract, or RapidOCR.

Web

Install web server dependencies for deploying agents as APIs:

pip install "upsonic[web]"

Use this when you need to deploy agents with FastAPI/Uvicorn or use Celery for background tasks.

Verify Installation

Check your installed version:

pip freeze | grep upsonic

You should see something like:

upsonic==X.X.X

Installation successful! You’re ready to create your first Agent and Task.