sanieldoe

sanieldoe / companions

Public

Self hosted, four purposed built ai helpers for organisation, creativity and reflection.

agent android app coding pi
42
1
100% credibility
Found May 11, 2026 at 42 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

Companions is a self-hosted application featuring four specialized AI agents that collaborate on a shared local vault of plain markdown files for reflection, mentoring, creativity, and knowledge management.

How It Works

1
🔍 Discover Companions

You find this app on GitHub and get excited about having four friendly AI helpers that work together on your own files.

2
📥 Install with one command

Run a simple script that sets everything up on your computer, checking what you need and getting ready to go.

3
🧙 Run the friendly setup wizard

Answer a few questions to pick your AI brain, choose where to store your notes, name your helpers with fun emojis, and get a special code.

4
📱 Pair your phone or open in browser

Scan a QR code with your phone app or enter the address and code to connect everything securely.

5
🚀 Launch and start chatting

Open the app, switch between your four companions, and begin journaling, brainstorming, or organizing thoughts.

✨ Your personal AI team is alive

Your notes stay safe in your vault, helpers remember everything, and you feel organized and creative every day.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 42 to 42 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is companions?

Companions is a self-hosted TypeScript app bundling four AI agents—Tracker for daily journaling, Mentor for step-by-step guidance, Shapeshifter for creative canvases, and Keeper for a personal wiki—all sharing a single vault of editable markdown files. Curl an install script to spin up the server, configure your LLM (Anthropic, OpenAI, or Ollama), and access via web or sideloaded Android APK with QR pairing over Tailscale. It solves fragmented AI tools by centralizing context in plain files, no database required.

Why is it gaining traction?

Unlike generic chatbots, it offers purpose-built ai companions github for real workflows: reflect without task overload, brainstorm beyond chat boxes, and query your own knowledge base. Self-hosted setup with opaque tokens, cron jobs, and file-sync support beats cloud dependencies, appealing to github self hosted ai starter kit hunters wary of pricing. Custom personas and shared vault create emergent companionship, echoing game vibes like companions bg3 or fallout 4.

Who should use this?

Solopreneurs and indie devs needing structured AI for daily rituals, debugging sessions, or project ideation without SaaS lock-in. Ideal for personal knowledge managers building wikis (companionship poe style) or reflective coders tracking progress in journal/projects folders. Pairs well with local Ollama for privacy-focused companionship support.

Verdict

Early-stage gem at 42 stars and 1.0% credibility score—v0.1.0 with strong docs, tests, and MIT license, but light on iOS and automation polish. Grab it for github self hosted runner docker if you crave custom companions github; skip if needing battle-tested scale.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.