### ๐ **The AI Receptionist Engine Built for Agencies & Resellers**
*Train once. Deploy unlimited. Your clients pay monthly. You keep the margin.*
[](https://www.npmjs.com/package/conny-ai)
[](LICENSE)
[](https://www.python.org/)
[](https://github.com/sxrubyo/conny)
[](https://github.com/sxrubyo/conny)
[](https://github.com/sxrubyo/conny)
---
## ๐ฐ Turn AI Assistants Into Recurring Revenue
**Conny** isn't just another chatbot framework.
It's a **white-label AI receptionist platform** that lets you sell branded conversational AI to restaurants, clinics, salons, real estate agencies, e-commerce stores โ **any business with a phone number.**
| Your Client's Pain | What They Pay You For |
|:---|:---|
| ๐ Missed calls = lost revenue | ๐ค 24/7 AI receptionist that never sleeps |
| ๐ฌ Slow WhatsApp & Telegram response | โก Instant replies with context memory |
| ๐ Answering the same questions manually | ๐ง AI trained on their FAQ, services, prices |
| ๐ Hiring, training, managing staff | ๐ Deploy once, forget about it |
---
## ๐ Your Business Model (The Conny Way)
```
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ 1. Install Conny (5 minutes) โ
โ npm install -g conny-ai โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ 2. Train ONE agent with a prompt (15 minutes) โ
โ "You are Maria, receptionist for a dental clinic. โ
โ Book appointments, answer FAQ, send price list." โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ 3. Clone to unlimited client instances (1 command) โ
โ conny sync --add /opt/conny-client-restaurant โ
โ conny sync --add /opt/conny-client-salon โ
โ conny sync --add /opt/conny-client-realestate โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ 4. Each client gets their own isolated instance โ
โ โ
WhatsApp Business API integration โ
โ โ
Telegram bot (optional) โ
โ โ
Custom personality via personas/ โ
โ โ
Isolated database & credentials โ
โ โ
Their own .env โ you never touch it again โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ 5. Charge $97โ$497/month per client โ
โ They manage their WhatsApp number โ
โ They update their FAQ via simple .txt files โ
โ You maintain the core and sync updates in 1 command โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
```
| Clients | Monthly Fee | Your MRR |
|:---:|:---:|:---:|
| 10 clients | $197/mo | **$1,970/mo** |
| 50 clients | $197/mo | **$9,850/mo** |
| 100 clients | $197/mo | **$19,700/mo** |
**Your cost:** $5โ15/mo per client (OpenAI API + server)
**Your margin:** 85โ95% ๐
---
## ๐ฏ Why Conny Destroys the Competition
| Solution |
Their Reality |
Conny Reality |
| Voiceflow / Botpress |
โ $99โ$625/mo per bot
โ Vendor lock-in
โ You pay per conversation |
โ
Open source, MIT license
โ
Unlimited instances
โ
You control pricing |
| n8n / Make / Zapier |
โ Complex workflow builders
โ No memory between sessions
โ Breaks with API changes |
โ
Zero external dependencies
โ
Built-in memory engine
โ
1 command to update all clients |
| Hiring a Dev Team |
โ $5,000โ$20,000 upfront
โ 3โ6 months development
โ Single-client solution |
โ
Install in 5 minutes
โ
Deploy client in 10 minutes
โ
One core, infinite clients |
| Custom Python Script |
โ No state management
โ Security nightmare
โ Dies when you restart |
โ
Production-grade FastAPI
โ
Zero-trust architecture
โ
Systemd + Docker ready |
---
## โก Start Selling in 3 Steps
### Step 1 โ Install Conny
```bash
npm install -g conny-ai
conny --version
```
### Step 2 โ Create Your First Agent
```bash
conny persona create restaurant-receptionist
```
Edit `personas/restaurant-receptionist.txt`:
```
You are Sofia, the AI receptionist for "La Cucina Bella" Italian restaurant.
Your job:
- Answer questions about menu, hours, location
- Take reservations (collect: name, phone, date, time, party size)
- Send the menu PDF when asked
- Be warm, friendly, professional
Hours: MonโSun 11amโ10pm
Location: 123 Main St, Miami, FL
When someone wants to book:
"Perfect! I'll need your name, phone number, preferred date & time, and party size."
Never confirm reservations โ say "I'll pass this to our manager to confirm."
```
### Step 3 โ Deploy to Client
```bash
conny sync --add /opt/conny-restaurant-bella
cd /opt/conny-restaurant-bella
cp .env.example .env
nano .env
python3 conny.py
```
**Done.** Their WhatsApp now has a 24/7 AI receptionist. You never touch their credentials again.
---
## ๐๏ธ Architecture
```
โโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Your Development Core โ
โ ~/conny-dev/ โ
โโโโโโโโโโโโโโฌโโโโโโโโโโโโโโ
โ conny sync
โโโโโโโโโโโโโโผโโโโโโโโโโโโโ
โ โ โ
โโโโโโโโโโผโโโโ โโโโโโโโผโโโโโโ โโโโโผโโโโโโโโโ
โ Client A โ โ Client B โ โ Client C โ
โ Restaurant โ โ Salon โ โ Real Estateโ
โโโโโโโโโโโโโโค โโโโโโโโโโโโโโค โโโโโโโโโโโโโโค
โ .env โ โ .env โ โ .env โ
โ persona โ โ persona โ โ persona โ
โ database โ โ database โ โ database โ
โ WhatsApp โ โ Telegram โ โ WhatsApp โ
โโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โโโโโโโโโโโโโโ
```
| Module | Purpose |
|:---|:---|
| **`conny.py`** | FastAPI orchestrator โ webhooks, routing, concurrency |
| **`conny_brain_v10.py`** | Memory layer โ context normalization, conversation history |
| **`conny_domino.py`** | Quality control โ validates responses before delivery |
| **`conny_core/`** | Shared conversation logic and state retention |
| **`conny_agents/`** | Pluggable skills โ calendar, CRM, payments, custom functions |
| **`personas/`** | Personality configs โ tone, language, brand voice per client |
---
## ๐ Core vs. Instance State
|
### โ
Synced to all instances
```
conny.py # Main engine
conny_brain_v10.py # Memory system
conny_domino.py # Quality control
conny_core/ # Shared logic
conny_agents/ # Skills & integrations
personas/ # Personality templates
requirements.txt # Dependencies
```
|
### โ Never synced (instance-specific)
```
.env # API keys, secrets
*.db # Conversation history
auth_info_*.txt # WhatsApp sessions
logs/ # Instance logs
backups/ # Local backups
```
|
**Updates are safe.** Sync the engine without ever touching client credentials or data.
---
## ๐ฎ CLI Reference
```bash
npm install -g conny-ai # Install globally
conny --version # Check version
conny sync --list # List all client instances
conny sync --add /opt/client # Register new client
conny sync --remove /opt/client # Remove client
conny sync -y # Push updates to all clients
conny persona create # New personality template
conny agent list # Show available agents
conny validate # Health check โ config, deps, files
```
---
## ๐ก๏ธ Security by Design
| Risk | Other Platforms | Conny |
|:---|:---|:---|
| API keys in version control | โ Common mistake | โ
`.env` never synced |
| Shared database across clients | โ GDPR violation | โ
Isolated SQLite per instance |
| Session hijacking | โ No isolation | โ
Separate auth per client |
| Cross-client data contamination | โ Possible | โ
Impossible by design |
---
## ๐ Industry Use Cases
| Industry | What the AI Handles | Suggested Price |
|:---|:---|:---:|
| ๐ **Restaurants** | Reservations, menu, hours, delivery | $147โ$297/mo |
| ๐ **Salons & Spas** | Bookings, services, prices, upsells | $197โ$397/mo |
| ๐ **Real Estate** | Lead qualification, listings, viewings | $297โ$597/mo |
| ๐ฆท **Medical / Dental** | Consultations, forms, reminders | $347โ$697/mo |
| ๐ **E-commerce** | Product questions, order tracking, returns | $197โ$497/mo |
| ๐๏ธ **Gyms & Studios** | Class bookings, schedules, memberships | $197โ$397/mo |
---
## ๐ฅ Production Deployment
### VPS (DigitalOcean, Linode, Vultr โ $6/mo)
```bash
npm install -g conny-ai
conny sync --add /opt/client-001
cd /opt/client-001
cp .env.example .env && nano .env
```
**Systemd service (auto-restart on crash):**
```ini
[Unit]
Description=Conny AI โ Client 001
After=network.target
[Service]
WorkingDirectory=/opt/client-001
ExecStart=/usr/bin/python3 /opt/client-001/conny.py
Restart=always
[Install]
WantedBy=multi-user.target
```
```bash
sudo systemctl enable conny-client-001
sudo systemctl start conny-client-001
```
### Docker
```bash
docker run -d \
--name conny-client-001 \
-p 8000:8000 \
-v /opt/client-001:/app \
--env-file /opt/client-001/.env \
conny-ai:latest
```
---
## ๐บ๏ธ Roadmap
- [ ] Web dashboard for clients (no-code persona editor)
- [ ] Multi-language personas (auto-switch by locale)
- [ ] Built-in analytics โ conversation metrics per instance
- [ ] Voice support โ Telegram voice โ transcription โ AI response
- [ ] Redis-backed session sharing for horizontal scaling
- [ ] Plugin marketplace โ community agents and skills
- [ ] Edge deployment โ Cloudflare Workers / Vercel Edge
---
## ๐ What You DON'T Need
โ n8n workflows โ Zapier subscriptions โ Voiceflow licenses
โ AWS Lambda complexity โ Kubernetes โ Redis (unless 500+ clients)
โ PostgreSQL โ Docker Swarm โ A dev team
**Conny runs on a $6/mo VPS. One server. Dozens of clients.**
---
## ๐ Ready to Build?
[](https://www.npmjs.com/package/conny-ai)
[](https://github.com/sxrubyo/conny/issues)
[](https://github.com/sxrubyo/conny/discussions)
---
**Built for agencies. Designed for profit. Engineered for scale.**
No vendor lock-in ยท No recurring SaaS fees ยท You own the code ยท You set the price
**Created by [sxrubyo](https://github.com/sxrubyo)** ยท MIT License ยท Open Source