https://github.com/darth-dodo/cocktail-cache
🍸 An AI-powered home bar advisor that helps you craft great mocktails and cocktails with whatever bottles you have.
https://github.com/darth-dodo/cocktail-cache
agents bartender crewai fastapi multi-agent-systems python3
Last synced: about 4 hours ago
JSON representation
🍸 An AI-powered home bar advisor that helps you craft great mocktails and cocktails with whatever bottles you have.
- Host: GitHub
- URL: https://github.com/darth-dodo/cocktail-cache
- Owner: darth-dodo
- License: mit
- Created: 2025-12-27T14:13:55.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-11T10:21:07.000Z (6 months ago)
- Last Synced: 2026-01-11T13:49:31.443Z (6 months ago)
- Topics: agents, bartender, crewai, fastapi, multi-agent-systems, python3
- Language: Python
- Homepage: https://cocktail-cache.onrender.com
- Size: 8.67 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Cocktail Cache
> **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.
---
## Meet Raja, Your AI Mixologist
**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.
---
## How It Works
### 1. Tell Raja What You Have
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.
### 2. Describe Your Mood
"Celebrating a promotion" • "Quiet evening alone" • "Cocktail nights with friends" • "Sunday afternoon vibes"
### 3. Get Your Perfect Drink
Raja recommends drinks you can actually make, with step-by-step instructions adapted to your skill level.
### 4. Know What to Buy Next
Raja tells you which single ingredient will unlock the most new drinks — maximum impact for your next purchase.
---
## Features
| 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 |
---
## Screenshots
Chat with Raja • Build Your Cabinet • Browse All Drinks
---
## Try It Now
**[cocktail-cache.onrender.com](https://cocktail-cache.onrender.com)**
No signup required. Just start chatting with Raja.
---
## For Developers
Tech Stack & Architecture
### Tech Stack
| Component | Technology |
|-----------|------------|
| **Runtime** | Python 3.12 |
| **API** | FastAPI |
| **AI** | CrewAI + Anthropic Claude |
| **Frontend** | Vanilla JS + Jinja2 + Tailwind |
| **Deployment** | Render |
### Codebase Health
| Metric | Value |
|--------|-------|
| **Test Suite** | 761 tests |
| **Code Coverage** | 78% |
| **Models** | 100% covered |
| **Services** | 96%+ covered |
| **Type Checking** | Strict mypy |
| **Linting** | Ruff + pre-commit hooks |
### Quick Start
```bash
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:8888
```
### Architecture
```mermaid
flowchart LR
User[User] --> Chat[Chat with Raja]
Chat --> AI[CrewAI Agents]
AI --> Claude[Anthropic Claude]
AI --> Data[(142 Drinks
180 Ingredients)]
AI --> Recipe[Recipe + Tips]
Recipe --> User
```
### AI Agents
- **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
### Documentation
- [Architecture](docs/architecture.md) — System design
- [Product Requirements](docs/product.md) — PRD and user stories
- [API Reference](docs/api.md) — 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 |
---
## License
MIT License — see [LICENSE](LICENSE) for details.
---
Built with
CrewAI •
Anthropic Claude •
FastAPI •
Tailwind CSS