UAG

Universal AI Gateway
Your AI models. Your tools. Your environment.

Quick start · Interfaces · Capabilities · Docs · 日本語 · Other languages

---

UAG is an open-source, local-first AI agent runtime that connects the language model you choose to the tools and systems you use. Work with code, files, browsers, services, and devices from a consistent interface—without tying your workflows to a single model provider.

Bring your model	Connect real tools	Stay in control
Hosted and local models, including OpenAI, Claude, Gemini, Grok, Bedrock, and Ollama.	Files, code, web, MCP, Agent Skills, plugins, cloud services, and IoT.	Local execution, human confirmation, credential storage, and configurable policies.

UAG is the agent execution layer, not a model provider. External model requests and connected-service calls depend on your configuration; local-first does not mean entirely offline or isolated by default.

Quick start

Requires Python 3.11+. Install from PyPI and launch the interactive CLI:

python -m pip install --upgrade uag
uag

On first launch, the setup wizard helps you choose a provider and configure its credentials. You can also configure providers through environment variables or the credential store.

For a larger set of provider and tool dependencies up front:

python -m pip install "uag[core,providers,tools]"

Then try asking:

> What changed in this Git repository? Summarize the risks.
> Find the latest documentation for this library and explain the migration steps.
> Inspect these files and produce a concise report.
> :help

New to UAG? See the Windows installation walkthrough (including Git and virtual-environment prerequisites) or the configuration reference. Platform-specific integrations are optional.

Interfaces

Use the same agent runtime and tool registry from multiple entry points.

Interface	Start with	Ideal for
CLI	uag	Terminal-first work and automation
Desktop	uagg	Native desktop conversations
Web	uagw	Browser-based conversations and rooms
A2A	uaga	Agent-to-agent integration
VS Code	Extension guide	Working alongside code

Desktop and Web interfaces use additional dependencies that are not included in the quick-start uag[core,providers,tools] installation:

# Desktop GUI (PySide6 and platform integrations)
python -m pip install "uag[platform]"

# Web UI (web authentication dependencies, FastAPI, and Uvicorn)
python -m pip install "uag[web]" fastapi uvicorn

The Web server can also attempt to install FastAPI and Uvicorn at launch; installing them up front does not depend on runtime auto-installation. See interface options and environment configuration for further setup.

What you can build

Capability	What UAG provides
Model-agnostic workflows	Switch among hosted and local providers using UAGENT_PROVIDER without rewriting tools.
Code and file operations	Repository navigation, Git inspection, linting, tests, file operations, and browser automation.
Extensible tooling	A catalog of 200+ tools, dynamic tool_catalog / tool_load discovery, custom Python and Rust-backed tools.
Connected agents	MCP servers, A2A, Claude Code-compatible plugins, Agent Skills, and sub-agents.
Long-running work	Auto-pilot, parallel independent read operations, scheduled tasks, restart recovery, and persisted sessions.
Beyond the terminal	Cloud and communication integrations, documents, media, realtime voice, and supported IoT protocols.

One runtime, many integrations

flowchart LR
    UI["CLI · Desktop · Web · VS Code · A2A"] --> UAG["UAG agent runtime"]
    UAG --> MODELS["Hosted & local models"]
    UAG --> TOOLS["Tools & extensions"]
    UAG --> STATE["Sessions & context"]
    TOOLS --> SYSTEMS["Files · Code · Web · MCP · Cloud · IoT"]
    POLICY["Confirmation · Credentials · Policy"] -.-> UAG

Loading

Provider examples: OpenAI, Anthropic, Gemini, Vertex AI, Azure OpenAI, Amazon Bedrock, Grok, DeepSeek, OpenRouter, Ollama, llama.cpp, and LM Studio. For provider-specific settings, see Environment variables.

Customize it with skills and plugins

Extend UAG without modifying the core. Install Agent Skills from SkillsMP or ClawHub, connect MCP servers, or load Claude Code-compatible plugins with tools, skills, agents, and hooks.

:skills mp_search browser automation
:plugin list
:plugin install <source>
:plugin marketplace list

Custom tools can expose TOOL_SPEC and run_tool(); Rust-backed tools are also supported. Start with the Tool Creator Guide, Plugin Development Guide, and MCP OAuth / Proxy Guide.

Built for real workflows

Context and memory

Large tool results can be saved as Artifacts instead of crowding the active model context. An agent can retrieve the relevant portion later using artifact_read. Sessions are stored in SQLite by default, with history search and explicit memory review workflows.

• Context compression
• Memory
• Session portability

Automation and collaboration

UAG supports parallel independent read operations, multi-agent coordination, session recovery, and Auto-pilot for multi-round work. Use :auto to start Auto-pilot; press F12 to interrupt the current response and request that Auto-pilot stop.

• Auto-pilot
• Timers and scheduled tasks
• Multi-agent runtime

Security and observability

Sensitive operations can require human_ask confirmation. Credentials can be stored in the operating system's credential manager or an encrypted file backend. The Web UI supports configured OIDC sign-in and access controls. OpenTelemetry tracing and metrics are opt-in.

• Enterprise policies
• MXC sandbox platform notes
• Remote Web / A2A MXC defaults
• Web identity and rooms
• OpenTelemetry design
• Developer observability guide

These are configurable controls, not a blanket guarantee that arbitrary tool execution is sandboxed. See the deployment and policy guides before exposing UAG to untrusted users or networks.

Languages, devices, and voice

UAG includes resources for 38 locales (English plus 37 translations), optional full-duplex voice integrations, and tools for systems such as SwitchBot, Matter, ECHONET Lite, BACnet, Modbus TCP, and OPC UA.

• Translations
• IoT use cases
• Communication tools

Documentation

Start here	Go deeper
Quickstart (Windows)	Architecture
CLI usage	Context management
Environment and providers	Enterprise policy
Agent Skills and plugins	Tool flow
MCP and OAuth	Computer Use
VS Code extension	Developer guide

Browse the documentation directory or read the Japanese README and other translations.

Development and contributing

git clone https://github.com/awaku7/agentcli.git
cd agentcli
python -m pip install -e ".[core,providers,test]"

Before a Python code pull request, run the relevant tests and project checks:

python -m ruff check src tests
python -m black --check src tests
python -m pytest -q .

Read AGENTS.md and the developer guide for detailed contribution guidelines. Issues, documentation improvements, tools, translations, and focused pull requests are welcome.

License

UAG is released under the Apache License 2.0.