LibreAI / AI Agents / OmAgent
// agents · om-ai-lab/OmAgent

OmAgent

Python library for building multimodal language agents — VLM, video and mobile, fast to prototype and ship

★ 2.7k stars⑂ 291 forksApache-2.0updated 2025-03
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

OmAgent is an open-source ai agents project by om-ai-lab (om-ai-lab/OmAgent on GitHub). It has 2,667 GitHub stars and 291 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 19 March 2025.

GitHub stars
2,667
Forks
291
License
Apache-2.0
Last updated on GitHub
19 March 2025
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Pick a multimodal task — e.g. answering questions about a video, a visual QA web app, or a phone-connected assistant.

  2. Get OmAgent

    pip install omagent-core, or clone the repo to work from the examples.

  3. Install and configure

    Generate container.yaml for an example with compile_container.py, and set your LLM key/endpoint (or point it at a local Ollama model) in configs/llms.

  4. Run your first agent

    Run the simple VQA example's webpage demo and ask a question about an image.

// features

Why people love it

Graph workflow engine

A flexible architecture with graph-based workflow orchestration and various memory types for contextual reasoning.

Native multimodality

Built-in support for VLM models, real-time APIs, computer vision models, video processing and mobile device connection.

Agent algorithms included

State-of-the-art unimodal and multimodal agent algorithms beyond simple LLM reasoning, e.g. ReAct, CoT and SC-CoT, packaged as reusable operators.

Local model support

Deploy your own models locally with Ollama or LocalAI instead of hosted APIs.

Distributed or Lite

A fully distributed architecture with custom scaling, or Lite mode that eliminates middleware deployment.

Worked examples

Video QA agent (Gradio app), mobile personal assistant, and an agentic-operators comparison project are included.

Advertisement
// run it

Run it yourself

  1. Clone the repo

    Clone OmAgent to use its examples; the library itself installs from PyPI in step 2.

    git clone https://github.com/om-ai-lab/OmAgent.git
    cd OmAgent
  2. Install the library

    Install omagent_core from PyPI (Python >= 3.10).

    pip install omagent-core
  3. Run the VQA demo

    Generate the example config and launch the webpage demo on http://127.0.0.1:7860.

    cd examples/step1_simpleVQA
    python compile_container.py
    python run_webpage.py
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains OmAgent?

om-ai-lab maintains it; the framework paper is Zhang et al., 2024 (arXiv:2406.16620), presented in the EMNLP 2024 context.

Is OmAgent free?

Yes, Apache-2.0 licensed.

Does it need a paid API key?

Only if you choose a hosted LLM/VLM — set your OpenAI-compatible key in the config, or run local models with Ollama/LocalAI instead.

How does it compare to LangChain-style frameworks?

The authors aim for a simpler interface with less overhead, while natively covering multimodal inputs (video, vision, mobile) that text-first frameworks treat as add-ons.

How do I get started?

pip install omagent-core, then run the step1_simpleVQA example: compile_container.py, configure your LLM, and python run_webpage.py.

// keep exploring

Similar tools

AI Agents

rivet

Rivet is Ironclad's visual IDE and TypeScript library for building complex AI agents and prompt chains

★ 4.7k starsMIT
View guide →
AI Agents

adk-python

Google's code-first toolkit for building real AI agents.

★ 21.7k starsApache-2.0
View guide →
AI Agents

MobileAgent

Mobile-Agent — multimodal GUI agents that operate phones and PCs from screenshots and instructions.

★ 9.3k starsMIT
View guide →
AI Agents

antigravity-sdk-python

Google's Python SDK for building AI agents on the Antigravity platform and Gemini models.

★ 3.7k starsApache-2.0
View guide →
AI Agents

smolagents

smolagents — Hugging Face's barebones agent library where agents think in code: a CodeAgent that writes its actions as Python, model-agnostic, Apache-2.0

★ 29.9k starsApache-2.0
View guide →
AI Agents

agent-framework

A framework for building, orchestrating and deploying AI agents and multi-agent workflows with support for Python and .NET.

★ 13.9k starsMIT
View guide →
// alternatives

Alternatives in AI Agents

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

Get OmAgent

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