selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

AISIX OSS logo

Self-host AISIX OSS

v1.7.1

Rust AI gateway unifying 100+ LLM providers via OpenAI API

ReleaseOpen SourceApache-2.0
Updated10 hours ago
LanguageRust
Setup difficultyModerate
Stars
207
Ports
3000 (OpenAI-compatible proxy API (chat/completions, embeddings, etc.)), 9090 (Metrics and status listener (Prometheus /metrics, /status/*)), 3001 (Admin listener (read-only resource surface, OpenAPI 3 with Scalar UI, playground))
Docker
ghcr.io/api7/aisix
Install with Docker
AISIX models page aliasing gpt-4o, claude-3-7-sonnet, bedrock-claude-prod, gemini-flash and others to upstream providers

What is AISIX OSS?

AISIX OSS is a Rust gateway that unifies many LLM providers behind one OpenAI-compatible API. The software executes as a single static binary with fast startup and lock-free config reads, supporting hot reloads via SIGHUP. Features include six routing methods, rate limiting with request and token budgets, content guardrails from multiple providers, exact-match caching with memory or Redis, MCP gateway for upstream MCP servers, A2A agent gateway, and OIDC/JWT auth with Entra ID, Okta, and Google Workspace. Observability covers Prometheus metrics, OTLP/GenAI spans to Langfuse, Honeycomb, Grafana Cloud, plus log exporters for Datadog and Aliyun SLS. Config uses one resources.yaml file or etcd for clusters. The same binary powers the commercial AISIX Enterprise and AISIX Cloud data planes.

Should you self-host AISIX OSS?

AISIX OSS scores 50/100 on selfhost.directory (how scoring works) and ranks #21 of 39 in API Gateway. It has 207 GitHub stars.

It shipped 2 stable releases in the past year. The latest, v1.7.1, came out on 27 October 2026. New versions land roughly every 5 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Rust.

Its closest alternative on selfhost.directory is Kong Gateway (82/100, 44 314 stars). It scores higher overall, so compare the two before you pick. See AISIX OSS vs Kong Gateway side by side.

Features

  • A2A agent gateway
  • Anthropic Messages API
  • Caching
  • Declarative Configuration
  • Ensemble models
  • Guardrails
  • MCP Gateway
  • Observability
  • OpenAI Compatible API
  • Operational endpoints
  • Rate limiting & concurrency
  • Routing & failover
  • Semantic routing

AISIX OSS README

How to install AISIX OSS

Install AISIX OSS with Docker

Docker
Environment variables
OPENAI_API_KEY, CALLER_API_KEY

docker run -d --name aisix
-v "$(pwd)/config.yaml:/etc/aisix/config.yaml:ro"
-v "$(pwd)/resources.yaml:/etc/aisix/resources.yaml:ro"
-e OPENAI_API_KEY -e CALLER_API_KEY
-p 3000:3000 -p 127.0.0.1:9090:9090
ghcr.io/api7/aisix:latest

Proxy on :3000, metrics/status on :9090 (keep on loopback or private network)

AISIX OSS releases & version history

More in API Gateway

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…