diff --git a/README.md b/README.md
index 7688342..55f70e2 100644
--- a/README.md
+++ b/README.md
@@ -1,41 +1,70 @@
# Dograh AI
-
β If you find value in this project, please STAR the Github repository to help others discover our FOSS platform!
+**The open-source, self-hostable alternative to Vapi & Retell** β build production voice agents with a drag-and-drop workflow builder. From zero to a working bot in under 2 minutes.
-
-
+
+
-
-
-
-
-
+
+
+
+
-
-
-
-
+
-**The open-source alternative to Vapi** - Dograh helps you build your own voice agents with an easy drag-and-drop workflow builder. It's the fastest way to build voice AI agents - from zero to working bot in under 2 minutes (our hard SLA standards).
+
+ π Docs Β·
+ π BSD 2-Clause
+
-- **100% open source**, self-hostable platform - no vendor lock-in, unlike proprietary solutions like Vapi
-- **Full control & transparency** - every line of code is open, with built-in AI testing personas and flexible LLM/TTS/STT integration
-- **Maintained by YC alumni and exit founders**, ensuring the future of voice AI stays open, not monopolized
+
+
+
-## π₯ Demo Video
+- **100% open source**, self-hostable β no vendor lock-in, unlike Vapi or Retell
+- **Full control & transparency** β every line of code is open, with flexible LLM / TTS / STT integration
+- **Maintained by YC alumni and exit founders**, committed to keeping voice AI open
+
+## π₯ Featured
+
+
+
+
+
+
+
Featured by Better Stack β a hands-on look at Dograh
+
+
+
+πΊ Prefer a 2-minute product walkthrough? Click here.
-
+
-
-
Click to watch a 2-minute demo of Dograh AI in action
+
+
+## βοΈ Dograh vs Vapi vs Retell
+
+An honest comparison on the axes that matter most to teams evaluating voice AI platforms.
+
+| | **Dograh** | **Vapi** | **Retell** |
+|---|---|---|---|
+| **License** | BSD 2-Clause (open source) | Proprietary | Proprietary |
+| **Self-hostable** | β
Yes β one Docker command | β SaaS only | β SaaS only |
+| **Pricing** | Free (self-host) Β· usage-based (cloud) | Per-minute SaaS | Per-minute SaaS |
+| **Bring your own LLM / STT / TTS** | β
Any provider, or use Dograh's stack | Configurable within their integrations | Configurable within their integrations |
+| **Source-level customization** | β
Every line is yours to modify | β Closed source | β Closed source |
+| **Data residency** | Your infra, your rules | Their cloud | Their cloud |
+| **Vendor lock-in** | None | Full | Full |
+
+
## π Get Started
##### Download and setup Dograh on your Local Machine
@@ -56,30 +85,17 @@ curl -o docker-compose.yaml https://raw.githubusercontent.com/dograh-hq/dograh/m
### ποΈ Your First Voice Bot
-1. **Open Dashboard**: Launch [http://localhost:3010](http://localhost:3010) on your browser
-2. **Choose Call Type**: Select **Inbound** or **Outbound** calling.
-3. **Name Your Bot**: Use a short two-word name (e.g., _Lead Qualification_).
-4. **Describe Use Case**: In 5β10 words (e.g., _Screen insurance form submissions for purchase intent_).
-5. **Launch**: Your bot is ready! Open the bot and click **Web Call** to talk to it.
-6. **No API Keys Needed**: We auto-generate Dograh API keys so you can start immediately. You can switch to your own keys anytime.
-7. **Default Access**: Includes Dograhβs own LLMs, STT, and TTS stack by default.
-8. **Bring Your Own Keys**: Optionally connect your own API keys for LLMs, STT, TTS, or telephony providers like Twilio.
+1. Open [http://localhost:3010](http://localhost:3010) in your browser.
+2. Pick **Inbound** or **Outbound**, name your bot (e.g. _Lead Qualification_), and describe the use case in 5β10 words (e.g. _Screen insurance form submissions for purchase intent_).
+3. Click **Web Call** β you're talking to your bot.
-## Quick Summary
-
-β‘ **Open-source alternative to Vapi** - 2-minute setup with hard SLA standards
-
-- π§ **No vendor lock-in**: Self-hostable platform vs proprietary SaaS solutions
-- π€ **AI Testing Personas**: Test your bots with LoopTalk AI that mimics real customer interactions
-- π **100% Open Source**: Every line of code is open - no hidden logic, no black boxes (unlike Vapi)
-- π **Flexible Integration**: Bring your own LLM, TTS, or STT - or use Dograh's APIs
-- βοΈ **Deploy anywhere**: Self-host or use our hosted version at app.dograh.com
+> π **No API keys needed.** Dograh ships with auto-generated keys and its own LLM / TTS / STT stack. Connect your own keys for LLM, TTS, STT, or Telephony (e.g. Twilio, Vonage, Telnyx) anytime.
## Features
### Voice Capabilities
-- Telephony: Built-in telephony integration like Twilio, Vonage, Vobiz, Cloudonix (easily add others)
+- Telephony: Built-in telephony integration like Twilio, Vonage, Vobiz, Cloudonix (easily add others), with support for transferring calls to human agents
- Languages: English support (expandable to other languages)
- Custom Models: Bring your own TTS/STT models
- Real-time Processing: Low-latency voice interactions
@@ -93,13 +109,9 @@ curl -o docker-compose.yaml https://raw.githubusercontent.com/dograh-hq/dograh/m
### Testing & Quality
-- LoopTalk (Beta): Create AI personas to test your voice agents
-- Workflow Testing: Test specific workflow IDs with automated calls
-- Real-world Simulation: AI personas that mimic actual customer behavior
-
-## Architecture
-
-Architecture diagram _(coming soon)_
+- **Test Mode**: Try your agent end-to-end before publishing, with no production calls or data affected
+- **In-Dashboard Web Calls**: Talk to your bot directly while building β no telephony setup required
+- **QA Node**: A built-in workflow node that analyzes prompt quality across your other nodes
## Deployment Options
@@ -111,10 +123,6 @@ Refer [Local Setup](https://docs.dograh.com/contribution/setup)
For detailed deployment instructions including remote server setup with HTTPS, see our [Docker Deployment Guide](https://docs.dograh.com/deployment/docker).
-### Production (Self-Hosted)
-
-Production guide coming soon. [Drop in a message](https://join.slack.com/t/dograh-community/shared_invite/zt-3czr47sw5-MSg1J0kJ7IMPOCHF~03auQ) for assistance.
-
### Cloud Version
Visit [https://www.dograh.com](https://www.dograh.com/) for our managed cloud offering.
@@ -125,12 +133,11 @@ You can go to [https://docs.dograh.com](https://docs.dograh.com/) for our docume
## π€Community & Support
-- GitHub Issues: Report bugs or request features
-- Slack: Our Slack community is not just for support β itβs the cornerstone of Dograh AI contributions. Here, you can:
- - Connect with maintainers and other contributors
- - Discuss issues and features before coding
- - Get help with setup and debugging
- - Stay up to date with contribution sprints
+> π **Coming from the Better Stack video?** Drop your use case in our [pinned GitHub Discussion](https://github.com/orgs/dograh-hq/discussions/291) β we read every reply and the founders personally onboard early adopters.
+
+- **Slack** β the cornerstone of Dograh AI contributions. Connect with maintainers, discuss features before coding, get help with setup, and stay current on contribution sprints.
+- **GitHub Discussions** β share use cases, ask questions, swap workflow recipes.
+- **GitHub Issues** β report bugs or request features.
π Join us β [Dograh Community Slack](https://join.slack.com/t/dograh-community/shared_invite/zt-3czr47sw5-MSg1J0kJ7IMPOCHF~03auQ)
@@ -146,6 +153,12 @@ We love contributions! Dograh AI is 100% open source and we intend to keep it th
- Push to the branch (git push origin feature/AmazingFeature)
- Open a Pull Request
+## β Star History
+
+
+
+
+
## π License
Dograh AI is licensed under the [BSD 2-Clause License](LICENSE)- the same license as projects that were used in building Dograh AI, ensuring compatibility and freedom to use, modify, and distribute.
diff --git a/docs/images/hero.gif b/docs/images/hero.gif
new file mode 100644
index 0000000..c98709b
Binary files /dev/null and b/docs/images/hero.gif differ