egregore/converse
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Chat UI and web frontend
5 commits 1 branch 0 tags 80 KiB
Find a file
Exact
egregore 23e3d05993 Remove model name from public-facing code 
Model selection now handled server-side. Follows branding
guideline to not expose implementation details (Claude, etc.)
in public interfaces.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 20:30:16 +00:00
static Remove model name from public-facing code 2026-02-02 20:30:16 +00:00
.gitignore Initial commit: Egregore web service 2026-02-02 11:37:41 +00:00
__init__.py Initial commit: Egregore web service 2026-02-02 11:37:41 +00:00
main.py Rename web service to converse 2026-02-02 12:45:43 +00:00
README.md Add README documentation 2026-02-02 19:56:55 +00:00

README.md

Converse Service

Chat UI and web frontend for Egregore.

Purpose

Serves the conversational web interface and handles user authentication. Acts as the public-facing entry point for human users interacting with the AI through a browser.

Endpoints

Endpoint Method Description
/ GET Chat interface (HTML)
/api/chat POST Send message, get response
/api/history GET Get chat history
/api/search GET Search messages
/api/transcribe POST Transcribe audio (Whisper)
/health GET Health check

Configuration

Environment variables (from ~/.env):

Variable Description Default
CHAT_USERNAME Basic auth username admin
CHAT_PASSWORD Basic auth password changeme
REASON_URL Reason service URL http://127.0.0.1:8081
RECALL_URL Recall service URL http://127.0.0.1:8082
OPENAI_API_KEY For audio transcription -

Running

# Activate venv
source ~/.venv/bin/activate

# Run directly
python main.py

# Or via systemd
sudo systemctl start converse
sudo systemctl status converse

Dependencies

  • FastAPI
  • httpx (async HTTP client)
  • openai (for Whisper transcription)

Architecture

Browser → Converse → Reason (AI processing)
                  → Recall (message storage)

Converse orchestrates requests between the user and backend services, handling authentication and session management.