blurt 🤖

Ramble an idea at your bot. Get a polished GitHub issue back.

Capture ideas before they disappear. blurt takes a rough message — a shower thought, a half-formed feature idea, a bug you noticed — and turns it into a structured GitHub issue, automatically.

No annoying forms. No more messy Notes. Just a message to your bot.

---

Features

• Discord + Telegram bots — send ideas from wherever you already are
• Multiple LLM providers — Gemini, OpenAI, Anthropic, or local Ollama
• Auto-structured output — title, summary, and tags generated from your raw input
• GitHub issue creation — issues land directly in your repo
• Self-hostable — runs with a single docker compose up -d
• Minimal friction — no UI, no accounts, just a bot message

---

Example

You send:

ok so like. bot that you ramble ideas at and it turns them into github issues. thats it. no forms no ui just message it like a friend and boom — structured issue in your repo. telegram discord whatever. want this

blurt creates:

• Title: Zero-friction idea capture bot via Telegram and Discord
• Summary: A bot users can message in natural language to capture project ideas. The bot structures the input into a GitHub issue with a title, summary, and tags — no forms, no UI, no context switching required.
• Tags: idea, bot, developer-tools
• Issue: https://github.com/you/my-idea-library/issues/1

---

How it works

1. Send a rough idea to your Discord or Telegram bot
2. blurt passes it to your configured LLM, which generates a title, summary, and tags
3. A GitHub issue is created in your repo
4. The bot replies with the issue title and link

---

Getting started

You'll need:

• Docker + Docker Compose
• A GitHub repo and a personal access token with Issues write permission
• An LLM API key — Gemini recommended (free tier available)
• A Discord bot token (Discord Developer Portal) or a Telegram bot token (@BotFather)

Run the quickstart:

curl -fsSL https://raw.githubusercontent.com/sholgaat/blurt/main/quickstart.sh -o /tmp/blurt-setup.sh && bash /tmp/blurt-setup.sh

The script collects your credentials and tells you when to run docker compose up -d.

Prefer to inspect first:

curl -fsSL https://raw.githubusercontent.com/sholgaat/blurt/main/quickstart.sh -o blurt-setup.sh
# read blurt-setup.sh
bash blurt-setup.sh

---

Advanced

Build images from source

By default, Docker pulls pre-built images. To build locally instead, before running docker compose up -d:

mv docker-compose.override.yml.disabled docker-compose.override.yml

Use a local LLM with Ollama

Don't trust Big LLM with your ideas? No problem — bring your own.

Run the quickstart and select Ollama as your LLM provider when prompted. You'll be asked for the Ollama base URL — you can either:

• Already have Ollama running? Provide the URL (e.g., http://192.168.1.100:11434)
• Want to set it up with blurt? Download the Ollama compose file and include it when running:

curl -fsSL https://raw.githubusercontent.com/sholgaat/blurt/main/docker-compose.ollama.yml -o docker-compose.ollama.yml
docker compose -f docker-compose.yml -f docker-compose.ollama.yml up -d
docker compose exec ollama ollama pull phi3:mini

The Docker network will make Ollama accessible at http://ollama:11434 from the backend.

Model data is persisted in the ollama-data volume across restarts.