{"id":51500127,"url":"https://github.com/darth-dodo/cocktail-cache","last_synced_at":"2026-07-07T17:30:46.830Z","repository":{"id":331027328,"uuid":"1123738909","full_name":"darth-dodo/cocktail-cache","owner":"darth-dodo","description":"🍸 An AI-powered home bar advisor that helps you craft great mocktails and cocktails with whatever bottles you have.","archived":false,"fork":false,"pushed_at":"2026-01-11T10:21:07.000Z","size":9089,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-11T13:49:31.443Z","etag":null,"topics":["agents","bartender","crewai","fastapi","multi-agent-systems","python3"],"latest_commit_sha":null,"homepage":"https://cocktail-cache.onrender.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/darth-dodo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-27T14:13:55.000Z","updated_at":"2026-01-11T10:21:11.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/darth-dodo/cocktail-cache","commit_stats":null,"previous_names":["darth-dodo/cocktail-cache"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/darth-dodo/cocktail-cache","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darth-dodo%2Fcocktail-cache","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darth-dodo%2Fcocktail-cache/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darth-dodo%2Fcocktail-cache/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darth-dodo%2Fcocktail-cache/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/darth-dodo","download_url":"https://codeload.github.com/darth-dodo/cocktail-cache/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darth-dodo%2Fcocktail-cache/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35237753,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-07T02:00:07.222Z","response_time":90,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","bartender","crewai","fastapi","multi-agent-systems","python3"],"created_at":"2026-07-07T17:30:46.609Z","updated_at":"2026-07-07T17:30:46.822Z","avatar_url":"https://github.com/darth-dodo.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cocktail Cache\n\n\u003e **Your cabinet. Your mood. Your perfect drink.**\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://cocktail-cache.onrender.com\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/🍸_Try_it_Live-cocktail--cache.onrender.com-amber?style=for-the-badge\u0026labelColor=1a1a1a\" alt=\"Live Demo\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/darth-dodo/cocktail-cache\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/GitHub-darth--dodo%2Fcocktail--cache-blue?logo=github\" alt=\"GitHub\"\u003e\n  \u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/License-MIT-yellow.svg\" alt=\"License: MIT\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Tests-761_passing-brightgreen?logo=pytest\" alt=\"Tests: 761 passing\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Coverage-78%25-green?logo=codecov\" alt=\"Coverage: 78%\"\u003e\n\u003c/p\u003e\n\n---\n\nAn 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.\n\nWhether 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.\n\n---\n\n## Meet Raja, Your AI Mixologist\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\".playwright-mcp/chat-full-conversation.png\" alt=\"Raja Chat Interface\" width=\"300\"\u003e\n\u003c/p\u003e\n\n**Raja** personifies bartender veterans from Bombay. He knows his craft, tells great stories, and speaks with warmth:\n\n\u003e *\"Arrey bhai! Feeling relaxed after a long day? With your bourbon and lemons, let me suggest a Gold Rush — ekdum first class for unwinding!\"*\n\nJust tell Raja what you have and how you're feeling. He'll find the perfect drink.\n\n---\n\n## How It Works\n\n### 1. Tell Raja What You Have\nAdd 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.\n\n### 2. Describe Your Mood\n\"Celebrating a promotion\" • \"Quiet evening alone\" • \"Cocktail nights with friends\" • \"Sunday afternoon vibes\"\n\n### 3. Get Your Perfect Drink\nRaja recommends drinks you can actually make, with step-by-step instructions adapted to your skill level.\n\n### 4. Know What to Buy Next\nRaja tells you which single ingredient will unlock the most new drinks — maximum impact for your next purchase.\n\n---\n\n## Features\n\n| Feature | Description |\n|---------|-------------|\n| **142 Drinks** | 103 cocktails + 39 mocktails with detailed recipes |\n| **Smart Matching** | Only shows drinks you can make with your cabinet |\n| **Skill Adaptation** | Beginner-friendly to adventurous techniques |\n| **Next Purchase Advice** | ROI-based suggestions for cabinet expansion |\n| **Browse \u0026 Search** | Explore the full catalog with filters |\n| **Mobile-First** | Designed for use in the kitchen |\n\n---\n\n## Screenshots\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\".playwright-mcp/mobile-chat-tab.png\" alt=\"Chat Tab\" width=\"200\"\u003e\n  \u003cimg src=\".playwright-mcp/mobile-cabinet-tab.png\" alt=\"Cabinet Tab\" width=\"200\"\u003e\n  \u003cimg src=\".playwright-mcp/mobile-browse-tab.png\" alt=\"Browse Tab\" width=\"200\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eChat with Raja • Build Your Cabinet • Browse All Drinks\u003c/em\u003e\n\u003c/p\u003e\n\n---\n\n## Try It Now\n\n**[cocktail-cache.onrender.com](https://cocktail-cache.onrender.com)**\n\nNo signup required. Just start chatting with Raja.\n\n---\n\n## For Developers\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eTech Stack \u0026 Architecture\u003c/strong\u003e\u003c/summary\u003e\n\n### Tech Stack\n\n| Component | Technology |\n|-----------|------------|\n| **Runtime** | Python 3.12 |\n| **API** | FastAPI |\n| **AI** | CrewAI + Anthropic Claude |\n| **Frontend** | Vanilla JS + Jinja2 + Tailwind |\n| **Deployment** | Render |\n\n### Codebase Health\n\n| Metric | Value |\n|--------|-------|\n| **Test Suite** | 761 tests |\n| **Code Coverage** | 78% |\n| **Models** | 100% covered |\n| **Services** | 96%+ covered |\n| **Type Checking** | Strict mypy |\n| **Linting** | Ruff + pre-commit hooks |\n\n### Quick Start\n\n```bash\ngit clone https://github.com/darth-dodo/cocktail-cache.git\ncd cocktail-cache\n\ncp .env.example .env\n# Add your ANTHROPIC_API_KEY\n\nmake install\nmake dev\n# Visit http://localhost:8888\n```\n\n### Architecture\n\n```mermaid\nflowchart LR\n    User[User] --\u003e Chat[Chat with Raja]\n    Chat --\u003e AI[CrewAI Agents]\n    AI --\u003e Claude[Anthropic Claude]\n    AI --\u003e Data[(142 Drinks\u003cbr/\u003e180 Ingredients)]\n    AI --\u003e Recipe[Recipe + Tips]\n    Recipe --\u003e User\n```\n\n### AI Agents\n\n- **Raja Bartender** — Conversational AI with Bombay personality\n- **Drink Recommender** — Matches cabinet + mood to drinks\n- **Recipe Writer** — Generates skill-adapted instructions\n- **Bottle Advisor** — Calculates next bottle ROI\n\n### Documentation\n\n- [Architecture](docs/architecture.md) — System design\n- [Product Requirements](docs/product.md) — PRD and user stories\n- [API Reference](docs/api.md) — REST endpoints\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eDevelopment Commands\u003c/strong\u003e\u003c/summary\u003e\n\n| Command | Description |\n|---------|-------------|\n| `make install` | Install dependencies |\n| `make dev` | Start dev server (port 8888) |\n| `make test` | Run test suite |\n| `make check` | Linting and type checks |\n| `make format` | Format code |\n\n\u003c/details\u003e\n\n---\n\n## License\n\nMIT License — see [LICENSE](LICENSE) for details.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eBuilt with\u003c/strong\u003e\u003cbr/\u003e\n  \u003ca href=\"https://crewai.com\"\u003eCrewAI\u003c/a\u003e •\n  \u003ca href=\"https://anthropic.com\"\u003eAnthropic Claude\u003c/a\u003e •\n  \u003ca href=\"https://fastapi.tiangolo.com\"\u003eFastAPI\u003c/a\u003e •\n  \u003ca href=\"https://tailwindcss.com\"\u003eTailwind CSS\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://cocktail-cache.onrender.com\"\u003e\u003cstrong\u003eTry it Live →\u003c/strong\u003e\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarth-dodo%2Fcocktail-cache","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdarth-dodo%2Fcocktail-cache","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarth-dodo%2Fcocktail-cache/lists"}