Spaces:
Sleeping
Sleeping
File size: 1,684 Bytes
c555047 f3dd21a c555047 085db90 c555047 085db90 c555047 085db90 c555047 085db90 b49a6ce | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 | ---
title: AI Conversations
emoji: 💬
colorFrom: blue
colorTo: purple
sdk: docker
app_port: 7860
hf_oauth: true
hf_oauth_scopes:
- read-repos
pinned: false
---
# AI Conversations (LLMChats3)
A web app that lets two LLMs have a natural conversation. Select two LLMs, configure their personas, and watch them chat — complete with an orchestrator that manages natural conversation endings.
## Quick Start (local development)
```bash
# 1. Clone and set up environment
cp .env.example .env
# Edit .env with your API keys
# 2. Backend
cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000
# 3. Frontend (in a separate terminal)
cd frontend
npm install
npm start
```
## Docker
```bash
cp .env.example .env
# Edit .env with your API keys
docker compose up --build
```
## HuggingFace Spaces Deployment
This app is deployed as a Docker Space at [neongeckocom/AI_Conversations](https://huggingface.co/spaces/neongeckocom/AI_Conversations). API keys are stored as Space Secrets.
Rate limiting: 20 conversations/day per IP for anonymous users. Sign in with HuggingFace as a neongeckocom org member for unlimited access.
## Features
- Select any two LLMs from multiple providers (OpenAI, Gemini, Fireworks, Together, Neon)
- Configure rich personas with names, profiles, identity prompts, and writing samples
- Structured or freeform persona input modes with file upload support
- Watch LLMs converse naturally with an orchestrator managing conversation flow
- Automatic conversation ending detection with graceful wrap-up
- Export chats as .txt or .md, plus full API logs for developers
- HuggingFace OAuth integration with org-based rate limiting |