Skip to main content

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:

  1. Detects which providers you have API keys for (from env vars)
  2. Serves a chat interface (the @geepers/chat widget)
  3. 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

Metadata

Release files for geepers-chat 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for geepers-chat 1.0.2
File Size Uploaded
geepers_chat-1.0.2.tar.gz 18.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for geepers-chat 1.0.2
File Interpreter ABI Platform
geepers_chat-1.0.2-py3-none-any.whl Python 3 none any Details

Total release size: 38.4 kB

Release files / geepers_chat-1.0.2.tar.gz

Download URL geepers_chat-1.0.2.tar.gz
Size 18.8 kB
Tags Source
SHA-256 checksum
How to use checksums
30f6750e1550171a9f15eea5ebb2fbaadf338767a703f073c8b27db48b7ca451
BLAKE2b-256 checksum
How to use checksums
fc8b5df28b5dbfd6cacf8ef0237fe2e7f7c836de19afb72abd1dcb8794d73c69
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.12

Release files / geepers_chat-1.0.2-py3-none-any.whl

Download URL geepers_chat-1.0.2-py3-none-any.whl
Size 19.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9ae439b2673fd78f634ea2dd9e2f8332edfd0072c898dff77ec5a4b297328cea
BLAKE2b-256 checksum
How to use checksums
f7c3ca4942f56103241279e1323e57d5b07c1d01e48d442e06f181c0818996e5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.12

Release history Release notifications | RSS feed

This release

1.0.2 This release

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page