One-command multi-provider LLM chat. pip install, one command, full chat UI with 18 providers.
Project description
geepers-chat
One-command multi-provider LLM chat UI. Install, run, chat.
Supports 18 providers out of the box via geepers-kernel: Anthropic, OpenAI, xAI, Mistral, Cohere, Gemini, Perplexity, Groq, HuggingFace, Ollama, and more.
Quick start
pip install geepers-chat
export ANTHROPIC_API_KEY=sk-ant-...
python -m geepers_chat
Browser opens with a full chat UI. Pick a model, start chatting.
How it works
The package runs a local Flask server that:
- Detects which providers you have API keys for (from env vars)
- Serves a chat interface (the @geepers/chat widget)
- Proxies your messages to provider APIs and streams responses back
No API keys leave your machine unless you're using gateway mode.
Gateway mode
If you don't have provider keys, the package can proxy through a gateway:
export GATEWAY_API_KEY=sk_...
python -m geepers_chat --gateway
Default gateway: https://api.dr.eamer.dev/v1
Options
python -m geepers_chat [options]
--port <n> Port (default: 3456)
--host <addr> Bind address (default: 127.0.0.1)
--gateway [url] Use gateway mode
--no-open Don't open browser
Environment variables
Set any of these to enable direct provider access:
| Variable | Provider |
|---|---|
ANTHROPIC_API_KEY |
Anthropic (Claude) |
OPENAI_API_KEY |
OpenAI (GPT) |
XAI_API_KEY |
xAI (Grok) |
MISTRAL_API_KEY |
Mistral |
COHERE_API_KEY |
Cohere |
GEMINI_API_KEY |
Google Gemini |
PERPLEXITY_API_KEY |
Perplexity |
GROQ_API_KEY |
Groq |
HF_API_KEY |
HuggingFace |
| (none needed) | Ollama (auto-detected if running locally) |
License
MIT. Luke Steuber
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file geepers_chat-1.0.2.tar.gz.
File metadata
- Download URL: geepers_chat-1.0.2.tar.gz
- Upload date:
- Size: 18.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
30f6750e1550171a9f15eea5ebb2fbaadf338767a703f073c8b27db48b7ca451
|
|
| MD5 |
42ea8906d5e5feb5b1d8dbf606875cd2
|
|
| BLAKE2b-256 |
fc8b5df28b5dbfd6cacf8ef0237fe2e7f7c836de19afb72abd1dcb8794d73c69
|
File details
Details for the file geepers_chat-1.0.2-py3-none-any.whl.
File metadata
- Download URL: geepers_chat-1.0.2-py3-none-any.whl
- Upload date:
- Size: 19.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9ae439b2673fd78f634ea2dd9e2f8332edfd0072c898dff77ec5a4b297328cea
|
|
| MD5 |
8755cdd27bbac4d2c3214505793173ce
|
|
| BLAKE2b-256 |
f7c3ca4942f56103241279e1323e57d5b07c1d01e48d442e06f181c0818996e5
|