Your cabinet. Your mood. Your perfect drink.
An AI-powered drink advisor that helps you craft great mocktails and cocktails with whatever ingredients you have. Chat with Raja, your AI mixologist, to get personalized drink recommendations, technique guidance, and smart suggestions for your next purchase.
Whether you are mixing spirits or skipping them entirely — designated drivers, health-conscious choices, Dry January, or simply in the mood for something refreshing without alcohol, Raja has you covered.
Raja personifies bartender veterans from Bombay. He knows his craft, tells great stories, and speaks with warmth:
"Arrey bhai! Feeling relaxed after a long day? With your bourbon and lemons, let me suggest a Gold Rush — ekdum first class for unwinding!"
Just tell Raja what you have and how you're feeling. He'll find the perfect drink.
Add your ingredients to your cabinet — spirits, mixers, bitters, juices, syrups, and fresh ingredients. Whether you stock a full bar or just have some citrus and ginger beer, your cabinet is saved automatically.
"Celebrating a promotion" • "Quiet evening alone" • "Cocktail nights with friends" • "Sunday afternoon vibes"
Raja recommends drinks you can actually make, with step-by-step instructions adapted to your skill level.
Raja tells you which single ingredient will unlock the most new drinks — maximum impact for your next purchase.
| Feature | Description |
|---|---|
| 142 Drinks | 103 cocktails + 39 mocktails with detailed recipes |
| Smart Matching | Only shows drinks you can make with your cabinet |
| Skill Adaptation | Beginner-friendly to adventurous techniques |
| Next Purchase Advice | ROI-based suggestions for cabinet expansion |
| Browse & Search | Explore the full catalog with filters |
| Mobile-First | Designed for use in the kitchen |
Chat with Raja • Build Your Cabinet • Browse All Drinks
No signup required. Just start chatting with Raja.
Tech Stack & Architecture
| Component | Technology |
|---|---|
| Runtime | Python 3.12 |
| API | FastAPI |
| AI | CrewAI + Anthropic Claude |
| Frontend | HTMX + Jinja2 + Tailwind |
| Deployment | Render |
| Metric | Value |
|---|---|
| Test Suite | 751 tests |
| Code Coverage | 78% |
| Models | 100% covered |
| Services | 96%+ covered |
| Type Checking | Strict mypy |
| Linting | Ruff + pre-commit hooks |
git clone https://github.com/darth-dodo/cocktail-cache.git
cd cocktail-cache
cp .env.example .env
# Add your ANTHROPIC_API_KEY
make install
make dev
# Visit http://localhost:8888flowchart LR
User[User] --> Chat[Chat with Raja]
Chat --> AI[CrewAI Agents]
AI --> Claude[Anthropic Claude]
AI --> Data[(142 Drinks<br/>180 Ingredients)]
AI --> Recipe[Recipe + Tips]
Recipe --> User
- Raja Bartender — Conversational AI with Bombay personality
- Drink Recommender — Matches cabinet + mood to drinks
- Recipe Writer — Generates skill-adapted instructions
- Bottle Advisor — Calculates next bottle ROI
- Architecture — System design
- Product Requirements — PRD and user stories
- API Reference — REST endpoints
Development Commands
| Command | Description |
|---|---|
make install |
Install dependencies |
make dev |
Start dev server (port 8888) |
make test |
Run test suite |
make check |
Linting and type checks |
make format |
Format code |
MIT License — see LICENSE for details.
Built with
CrewAI •
Anthropic Claude •
FastAPI •
HTMX