Skip to main content

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:

  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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

geepers_chat-1.0.0.tar.gz (18.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

geepers_chat-1.0.0-py3-none-any.whl (19.6 kB view details)

Uploaded Python 3

File details

Details for the file geepers_chat-1.0.0.tar.gz.

File metadata

  • Download URL: geepers_chat-1.0.0.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

Hashes for geepers_chat-1.0.0.tar.gz
Algorithm Hash digest
SHA256 424e7a012c19eb1950954bc6bdf4e5164590b32b8bfdf82cd4268ef2c9ee5165
MD5 9af2d43996f2afd315ac1e6696916688
BLAKE2b-256 fa33390303c1faf948b3568d3ccaf14a350ffdf69e5e5f847056c54fb6f13b9c

See more details on using hashes here.

File details

Details for the file geepers_chat-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: geepers_chat-1.0.0-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

Hashes for geepers_chat-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7130042c38fde77e4643ff94b2feb990a7c900ae21341fb038e9eedf4b5a4929
MD5 ddb601c73401505c6308461d680886b3
BLAKE2b-256 b870cf871396bdd8f947067f8562ad53365ea9a67d906df1968c2944230aeb7a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page