Skip to content

thebardchat/shanebrain-core

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

118 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ShaneBrain Core

ShaneBrain Core

The heart of the ShaneBrain AI Ecosystem. Everything lives here.

Constitution Services MCP Tools Weaviate Platform Hugging Face Sponsor

Personal AI legacy system running on a Raspberry Pi 5 in a closet in Alabama. Discord bot, RAG, social automation, voice pipeline, MCP server, and more — all on one machine.


One Pi. Everything.

What's Running

Nine services. One Pi 5. 16GB RAM. Zero cloud dependencies.

Service Port What It Does
Ollama 11434 Local LLM inference — shanebrain-3b, llama3.2:3b, nomic-embed-text
Weaviate 8080 Vector database — 17 collections, 250+ objects, semantic search
MCP Server 8100 27 AI tools via streamable-http — knowledge, chat, vault, planning, security
Angel Cloud Gateway 4200 Public-facing FastAPI — auth, chat, leaderboard, Discord/GitHub linking
Discord Bot RAG-powered conversational AI with persistent memory
Social Bot Automated Facebook posting with AI-generated content, signed as AI
Arcade Bot Discord casino with Ko-fi premium integration
Voice Pipeline 8200 Record on phone, Whisper transcription, text on Pi
SRM Dispatch 5173 React/Vite PWA — daily route planning for 18 dump truck drivers

Architecture

System Architecture
┌─────────────────────────────────────────────────────────────┐
│                    RASPBERRY PI 5 (16GB)                     │
│                  Pironman 5-MAX · RAID 1                     │
│               2x WD Blue SN5000 2TB NVMe                    │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐   │
│  │  Ollama   │  │ Weaviate │  │   MCP    │  │  Docker  │   │
│  │  :11434   │  │  :8080   │  │  :8100   │  │  Engine  │   │
│  │ 4 models  │  │ 17 colls │  │ 27 tools │  │ 5 cont.  │   │
│  └─────┬────┘  └────┬─────┘  └────┬─────┘  └────┬─────┘   │
│        │            │             │              │          │
│  ┌─────┴────────────┴─────────────┴──────────────┴─────┐   │
│  │              Systemd Service Layer                   │   │
│  ├──────────────────────────────────────────────────────┤   │
│  │ shanebrain-discord  │  shanebrain-social             │   │
│  │ shanebrain-arcade   │  angel-cloud-gateway           │   │
│  │ voice-dump          │  srm-dispatch                  │   │
│  │ github-poller       │  restic backup (3 AM)          │   │
│  │ weaviate-backup     │  rojo-angel-cloud              │   │
│  └──────────────────────────────────────────────────────┘   │
│                                                             │
│  Storage: /mnt/shanebrain-raid/ (RAID 1)                    │
│  Network: Tailscale VPN (100.67.120.6)                      │
│  Public:  Tailscale Funnel (HTTPS, auto-TLS)                │
└─────────────────────────────────────────────────────────────┘

MCP Server — 42 Tools

27 MCP Tools

The brain's API. Every tool prefixed shanebrain_, all accessible via Claude Code, Discord, or any MCP client.

Group Tools What They Do
Knowledge search_knowledge, add_knowledge RAG search + ingest across 153 knowledge objects
Chat chat, get_conversation_history, log_conversation Conversational AI with memory
RAG Admin rag_delete, rag_list_classes Manage Weaviate collections
Social search_friends, get_top_friends Friend profiles and relationship context
Vault vault_add, vault_search, vault_list_categories Encrypted personal document storage
Notes daily_note_add, daily_note_search, daily_briefing Journal, todos, and morning briefings
Drafts draft_create, draft_search Writing draft pipeline
Security security_log_recent, security_log_search, privacy_audit_search Failed logins, account linking, audit trail
Admin system_health, ollama_list_models Infrastructure monitoring
Ollama ollama_generate, ollama_list_models Direct LLM inference
Planning plan_write, plan_read, plan_list Persistent markdown planning system
Weather weather Hazel Green AL current conditions + 3-day forecast
Reminders reminder_add, reminder_check Set and track reminders with priority and due time
Audiobook audiobook_status Track recorded vs unrecorded book chapters
Service Mgmt service_restart Restart allowlisted systemd services
Backup backup_status Check restic + weaviate backup health
Infrastructure disk_usage RAID/SD/external drive usage with alerts
GitHub github_stats Star counts and Starstruck progress across repos
LED led_control Pironman 5 RGB — color, flash, breathe, off
Voice voice_dumps_list List recent recordings and transcript status
Cron cron_list All cron jobs and systemd timers
Sobriety sobriety_days Days sober since 11/27/2023
Quick Note quick_note Ultra-fast note, zero friction
Docker docker_status Running containers with health and uptime
Knowledge Stats knowledge_stats RAG breakdown by category and source

Weaviate Collections

17 collections, all vectorized with text2vec-ollama + nomic-embed-text (768-dim):

Collection Objects Purpose
LegacyKnowledge 153 Core RAG — BGKPJR research, wisdom, technical docs
Conversation 61 Chat memory across all interfaces
FriendProfile 5 People Shane knows — context for AI interactions
PersonalDoc 12 Vault — credentials, teaching, personal docs
DailyNote 5 Journal entries and daily todos
PersonalDraft 1 Writing drafts in progress
SecurityLog active Failed logins, registrations, unauthorized API calls
PrivacyAudit active Account creation, password changes, cross-platform linking
SocialKnowledge 1 Social bot personality and posting context
+ 8 training collections 22 BrainDoc, BusinessDoc, Document, DraftTemplate, etc.

The Roblox Game

"The Cloud Climb" — a full Roblox game built in Luau, synced via Rojo.

  • 32 Luau files: 16 server modules, 9 client modules, 4 config modules
  • 6 cloud layers matching Angel Cloud's angel levels
  • 65 lore fragments from WISDOM-CORE.md
  • 7 Guardian Trials (cooperative mini-games)
  • RetroSystem: phone booths with rotary dial codes
  • Brown starfish (Claude logo tribute) hidden as collectible easter eggs
  • Ethical monetization: cosmetic-only, never sell progression

Hardware

Component Spec
Raspberry Pi 5 16GB RAM — the brain
Pironman 5-MAX NVMe RAID 1 chassis — the spine
2x WD Blue SN5000 2TB RAID 1 via mdadm — the memory
8TB Seagate USB Cold backup at /media/shane/ANGEL_CLOUD

Storage layout:

  • /mnt/shanebrain-raid/ — all services, Docker, Ollama models, containerd
  • SD card at 44% (16GB free) — OS only
  • RAID at 19GB used — room to grow

Quick Start

# Clone
git clone https://github.com/thebardchat/shanebrain-core.git
cd shanebrain-core

# The Pi runs everything via systemd — no manual startup needed
# To check status:
systemctl status shanebrain-discord shanebrain-social voice-dump angel-cloud-gateway

# MCP server health:
curl http://localhost:8100/health

# Ollama models:
ollama list

The Ecosystem

Every repo connects back to this core:

shanebrain-core (you are here)
  ├── shanebrain_mcp        → MCP server (mirrored from mcp-server/)
  ├── angel-cloud            → Public wellness platform
  ├── pulsar_sentinel        → Post-quantum security
  ├── MASTER-Scheduler-SRM   → Dispatch operations
  ├── AI-Trainer-MAX         → 36-module training curriculum
  ├── HaloFinance            → Financial planning
  ├── noir-detective-...     → Book writing pipeline
  ├── book-launch-playbook   → Publishing framework
  └── constitution           → The covenant that governs it all

Built With

Claude by Anthropic
AI partner and co-builder.
Not a tool. A partner.


claude.ai
Raspberry Pi 5
The compute that made
local AI affordable.


raspberrypi.com
Pironman 5-MAX
NVMe RAID 1 chassis
by Sunfounder.


sunfounder.com
Hugging Face
AI models, image generation,
open-source community.


huggingface.co

"I could not have done any of this without them."


Support This Work

  • Sponsor on GitHub — keeps the RAID spinning
  • Buy the bookYou Probably Think This Book Is About You
  • Star this repo — visibility matters for projects like this

Part of the ShaneBrain Ecosystem · Built under the Constitution

"If you don't own your infrastructure, you don't own your future."

Hazel Green, Alabama · 2026

About

The heart of the ShaneBrain ecosystem — 9 services on one Pi 5: Discord bot, RAG, 27-tool MCP server, social automation, voice pipeline, dispatch PWA. All local. All yours.

Topics

Resources

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors