{"repo":"dvoraknc/heatherbot","free":true,"listed":false,"github":"https://github.com/dvoraknc/heatherbot","clone":"git clone https://github.com/dvoraknc/heatherbot.git","description":"Fully local, persona-driven AI companion bot for Telegram (Telethon) with optional Discord bridge. Modular text pipeline, per-user memory + semantic recall, on-demand image generation, and TTS — runs on consumer dual-GPU hardware.","language":"Python","stars":18,"topics":["ai-companion","chatbot","comfyui","discord-bot","llama-cpp","llm","local-ai","persona","python","self-hosted"],"license":"MIT","category":"ai-agents","readme_excerpt":"HeatherBot A fully local, persona-driven AI companion chatbot for Telegram (with an optional Discord bridge). HeatherBot is a Telegram userbot (MTProto via Telethon) that runs entirely on your own hardware. No cloud APIs, no OpenAI, no subscriptions. Just a local LLM, a persona YAML file, and a stack of services that make the bot feel like a real person texting. The core is the Telegram companion bot plus its persona, memory, media, and post-processing pipeline. An optional Discord bridge runs the same character in Discord. Everything runs locally. The thesis: a well-scaffolded 12B parameter model with the right persona engineering, adaptive kink personas, content pipeline, and post-processing can deliver a compelling companion experience that rivals cloud-hosted solutions — while keeping everything private and under your control. Setting it up? See AGENTS.md — a detailed, ordered bootstrap runbook written so a coding agent (Claude Code, Codex) or a human can stand the system up on a fresh machine, including the local-LLM, memory, and optional-service setup. Start there. Architecture Service Port Required Purpose --------- ------ ---------- --------- llama-server 1234 Yes Text generation (llama.cpp with any GGUF model) Ollama 11434 No Image analysis (LLaVA) + embeddings for vector memory ComfyUI 8188 No Image generation (FLUX.1 / SDXL) with face-swap workflows Chatterbox TTS 5001 No Local voice synthesis (ElevenLabs API is the cloud option) Bot Monitor 8888 No Web dashboard f","default_branch":null,"files":null,"tree":[],"storefront":"/r/dvoraknc","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/dvoraknc/heatherbot/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}