Quick Start

Run Zeph after building and interact via CLI, Telegram, or a cloud provider.

CLI Mode (default)

Unix (Linux/macOS):

./target/release/zeph

Windows:

.\target\release\zeph.exe

Type messages at the You: prompt. Type exit, quit, or press Ctrl-D to stop.

Unix (Linux/macOS):

ZEPH_TELEGRAM_TOKEN="123:ABC" ./target/release/zeph

Windows:

$env:ZEPH_TELEGRAM_TOKEN="123:ABC"; .\target\release\zeph.exe

Restrict access by setting telegram.allowed_users in the config file:

[telegram]
allowed_users = ["your_username"]

When using Ollama (default provider), ensure both the LLM model and embedding model are pulled:

ollama pull mistral:7b
ollama pull qwen3-embedding

The default configuration uses mistral:7b for text generation and qwen3-embedding for vector embeddings.

For Claude:

ZEPH_CLAUDE_API_KEY=sk-ant-... ./target/release/zeph

For OpenAI:

ZEPH_LLM_PROVIDER=openai ZEPH_OPENAI_API_KEY=sk-... ./target/release/zeph

See Configuration for the full reference.