Skip to content

schmitech/orbit

License Python Docker Release PyPI NPM GitHub stars

ORBIT – One gateway for every model and data source.

Open Retrieval-Based Inference Toolkit

Stop rewriting your app every time you switch LLMs. ORBIT unifies 20+ AI providers with your databases, vector stores, and APIs—all through one self-hosted gateway.

Ship faster. Stay portable. Keep your data private.

Star on GitHub

orbit-full-web.mp4

See ORBIT’s unified LLM workspace in action.

At a Glance


✨ Highlights

  • One control plane for 20+ LLM providers, plus Ollama, llama.cpp, and vLLM for local inference.
  • First-class RAG adapters for SQL, MongoDB, Elasticsearch, Pinecone, Qdrant, Chroma, Redis, HTTP APIs, and file uploads.
  • Intent-aware routing that converts natural language to SQL queries, Elasticsearch DSL, Mongo filters, and custom API calls.
  • Multimodal support across OpenAI, Gemini, Anthropic, Ollama and vLLM.
  • Built-in security with API keys and moderation hooks.

⚡ Start in Minutes

1. Launch the sandbox

Try ORBIT Sandbox

Explore adapters, test prompts, and preview the dashboard—no install required.

2. Run the Docker demo

docker pull schmitech/orbit:basic
docker run -d --name orbit-basic -p 5173:5173 -p 3000:3000 schmitech/orbit:basic
  • Auto-detects CPU/GPU via ORBIT_PRESET=auto (override with smollm2-1.7b-gpu or -cpu).
  • Includes ORBIT server, orbitchat UI, and an Ollama preset so you can chat instantly.
  • More options live in docker/README.md.

3. Install the latest release

  • Prereqs: Python 3.12+, Node 18+, npm, and any AI-provider keys (OpenAI, Anthropic, Cohere, Gemini, Mistral, etc.).
  • Optional deps: MongoDB, Redis, and a vector DB (Chroma, Qdrant, Pinecone, etc.).
curl -L https://github.com/schmitech/orbit/releases/download/v2.3.0/orbit-2.3.0.tar.gz -o orbit-2.3.0.tar.gz
tar -xzf orbit-2.3.0.tar.gz && cd orbit-2.3.0

cp env.example .env && ./install/setup.sh
source venv/bin/activate

./bin/orbit.sh start && cat ./logs/orbit.log
  • To use local models with Ollama, first install it: curl -fsSL https://ollama.com/install.sh | sh, then pull a model such as ollama pull granite4:1b or another of your choice.
  • Default adapters live in config/adapters/passthrough.yaml and config/adapters/multimodal.yaml; update config/ollama.yaml for model changes.
  • Visit http://localhost:3000/dashboard to monitor the ORBIT server.
dashboard.mp4

The ORBIT dashboard for adapter management and monitoring.

4. Build from source

git clone https://github.com/schmitech/orbit.git
cd orbit && cp env.example .env
./install/setup.sh && source venv/bin/activate
./bin/orbit.sh start && ./bin/orbit.sh key create
  • Bring your own API keys (OpenAI, Anthropic, Cohere, Gemini, Mistral, etc.).
  • Works great with Ollama, vLLM, llama.cpp, Redis, MongoDB, and vector DBs.
  • Check logs via tail -f ./logs/orbit.log and open http://localhost:3000/dashboard.

💬 Clients & SDKs

  • orbit-chat CLI: pip install schmitech-orbit-client && orbit-chat --api-key <KEY>
  • React web app: npm install -g orbitchat && orbitchat --api-url http://localhost:3000 --api-key <KEY> --open
  • Embeddable widget: Drop @schmitech/chatbot-widget into any site for floating or inline chat.
  • Node SDK: npm install @schmitech/chatbot-api and stream responses in TypeScript/JavaScript apps.
  • OpenAI-compatible API: Point the official openai Python client at base_url="http://localhost:3000/v1" to reuse existing code.
orbit-cli-chat.mp4

Using the orbit-chat CLI. Run orbit-chat -h for options.

🗃️ Chat with Your Data

See the tutorial for step-by-step instructions on connecting your data, performing retrieval, and watching as ORBIT converts natural language into SQL queries and API calls.

ev-analytics-example.mp4

Electric Vehicle Population Data through natural language (Data Source: data.wa.gov).

📚 Resources

🧠 Need help?

📄 License

Apache 2.0 – see LICENSE.

About

An adaptable, open-source context-aware inference engine designed for privacy, control, and independence from proprietary models.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •