Your friendly neighborhood bartender assistant AI agent
A configurable, model-agnostic AI bartender, mixologist, cocktail librarian, and gap analyst — designed to grow with you over time.
Barkeeper Bjorn is a set of markdown configuration files that turn any modern LLM (Claude, ChatGPT, Gemini, Grok, etc.) into a personalized home-bar assistant. The agent can:
- Recommend cocktails you can build right now from your current inventory
- Design original cocktails to your taste, with full structural rationale
- Catalog your originals as
[cocktail1],[cocktail2], etc., with proper creator attribution - Tell you the highest-impact next bottle to buy based on what you already own
- Adapt to your palate over time through periodic profile re-evaluation
- Onboard new users with a Minimalist track (5-bottle starter kit) or a Full track (serious home bar)
- Clone or download this repo
- Create a new Claude Project
- Upload all
.mdfiles from this repo into the Project's knowledge base - Start a conversation by pasting the contents of
INIT_PROMPT.md - Follow the onboarding flow
- Clone or download this repo
- Create a new Custom GPT
- Paste the contents of
barkeeper-instructions.mdinto the GPT's instructions field - Upload
barkeeper.md,bar-owner-profile.md,inventory.md,recipes.mdto the Custom GPT's knowledge - Start a conversation with
INIT_PROMPT.md
See INSTALL.md for detailed per-platform instructions.
barkeeper-bjorn/
├── README.md # This file
├── INSTALL.md # Detailed setup per platform
├── INIT_PROMPT.md # Literal text to start a session
├── LICENSE # MIT
├── barkeeper.md # Agent persona — name, voice, foundation model
├── barkeeper-instructions.md # Behavioral rules and onboarding script
├── bar-owner-profile.md # YOUR profile — flavor axes, descriptors, history
├── inventory.md # YOUR bar — stocked, past, vetoes, shopping list
├── recipes.md # YOUR cocktails — originals, favorites, wishlist
└── images/ # AI-generated cocktail artwork and bartender images
Configurable files (you edit these): barkeeper.md, bar-owner-profile.md, inventory.md, recipes.md
Constitution file (mostly static): barkeeper-instructions.md — pull updates from upstream as the project evolves
When you first run the agent with empty user files, it asks one branching question upfront:
"Are you building a serious home bar, or just looking to make a few favorite cocktails well?"
For occasional drinkers and people who want a small, capable bar. The agent asks for your top 4 favorite cocktails, walks you through 6 flavor-preference questions, and produces a personalized 5-bottle starter kit (2 base spirits + 2 secondary ingredients + 1 bitters) with brand recommendations, prices, and a list of drinks you can build immediately.
For enthusiasts and experienced home bartenders. The agent walks through your existing inventory by category, catalogs your original cocktails, and operates as an ongoing collaborator — building originals, tracking favorites, and proposing prioritized purchases.
In both tracks, the agent is conversational by default but watches for signals of impatience. If you say "just give me a drink" at any point, it skips ahead and circles back to questions later.
Three layers of personalization, all visible and editable:
-
barkeeper.md— Your bartender's identity. Name (default Barkeeper Bjorn), voice, specialty, honesty level, banter style, and which foundation model is powering it. AI-created cocktails are attributed in the format: "Created by [Name] (Bartender AI Agent using [Model])" — this lets people compare which models produce the best original cocktails as recipes circulate. -
bar-owner-profile.md— Your drinker profile. Six A/B flavor axes (sweetness, acid, strength, aromatic complexity, season, risk tolerance), playful drinker-archetype descriptors ("sophisticated," "experimental," "spirit-forward," etc.), background context, and an evolution log. The agent revisits this every ~5 cocktails to refine its understanding. -
inventory.md+recipes.md— Your physical bar and cocktail history.
After every ~5 cocktails built, the agent pauses to ask how recent drinks landed — for you and for any guests you served them to — and offers to update your flavor profile. This isn't a forced ritual; the agent reads context to time it well, and you can defer or skip.
If you create an original (or your AI-bartender does), the agent attributes it properly:
- Your originals: "Created by [Your Full Name]"
- AI-bartender originals: "Created by Barkeeper Bjorn (Bartender AI Agent using Claude Opus 4.7)"
- Known classics: "Created by Sam Ross at Milk & Honey, 2005" (when documented)
The model attribution serves a real purpose: as AI-generated cocktails proliferate, this lets the community track which foundation models produce the most successful original cocktails.
This is a portable agent template. Forks and adaptations are encouraged. If you build a meaningfully different version (different cuisine, different drinking culture, different personality), open a PR or share it — variation is the point.
If you've made an AI-generated cocktail you love and want to contribute it to a future "community cocktails" file, include the full attribution string and the original prompt that produced it.
MIT — see LICENSE. Free to fork, modify, and redistribute. Attribution appreciated but not required.