# Unified AI System

> A terminal-first, self-hosted AI gateway and governed MCP server for Codex, Cursor, and Cline.

Unified AI System provides one governed boundary for models, agents, knowledge, workflows, and tools. The first verified path uses a local fake provider, requires no account or API key, and makes no real-provider calls.

## Start here

- [Project homepage](https://happy520ai.github.io/unified-ai-system/)
- [Chinese project homepage](https://happy520ai.github.io/unified-ai-system/index.zh-CN.html)
- [Run an MCP server in Codex with Docker](https://happy520ai.github.io/unified-ai-system/codex-mcp-docker-quickstart.html)
- [Codex MCP Docker 中文教程](https://happy520ai.github.io/unified-ai-system/codex-mcp-docker-quickstart.zh-CN.html)
- [Why an AI gateway should be terminal-first](https://happy520ai.github.io/unified-ai-system/terminal-first-ai-gateway.html)
- [Source repository](https://github.com/happy520ai/unified-ai-system)
- [Installable Agent Skill](https://skills.sh/happy520ai/unified-ai-system/unified-ai-gateway)
- [60-second Codex MCP quickstart](https://github.com/happy520ai/unified-ai-system/blob/master/docs/codex-mcp-quickstart.md)
- [Getting started](https://github.com/happy520ai/unified-ai-system/blob/master/docs/getting-started.md)
- [Natural-language prompt enhancement](https://github.com/happy520ai/unified-ai-system/blob/master/docs/prompt-enhancement.md)
- [Architecture](https://github.com/happy520ai/unified-ai-system/blob/master/docs/architecture.md)
- [Security policy](https://github.com/happy520ai/unified-ai-system/blob/master/SECURITY.md)

## Public distributions

- [Release v0.4.0](https://github.com/happy520ai/unified-ai-system/releases/tag/v0.4.0)
- [Official MCP Registry entry](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.happy520ai%2Funified-ai-system/versions/0.4.0)
- Agent Skill: `npx skills add happy520ai/unified-ai-system --skill unified-ai-gateway --agent codex --copy --yes`
- MCP container: `ghcr.io/happy520ai/unified-ai-system/mcp-server:0.4.0`
- Gateway demo container: `ghcr.io/happy520ai/unified-ai-system/ai-gateway-service:0.4.0`

## Verified boundaries

- The stable v0.4.0 MCP image and current source both expose nine tools, including provider-free prompt enhancement.
- Plain chat requests remain unchanged unless prompt enhancement is explicitly enabled.
- The credential-free default uses `local-fake-provider` in `fake` execution mode.
- Real-provider execution requires explicit, scoped authorization.
- Production readiness, L5 autonomy, and AGI require independent evidence.
- License: Apache-2.0.