awesome-ai-companion

Awesome AI Companion

Software, infrastructure, and communities for long-term AI companion relationships.

人机恋开源项目大全 · 面向长期 AI 伴侣关系的开源软件、基础设施与社区。

English · 中文版

We read the code of every project here, and each description says what it actually does. New entries are also scanned automatically for malware, malicious-code patterns, and known vulnerable dependencies. Anything unfinished or unclear is tagged verify or adapt.

Status: ready = usable as an app or service · adapt = needs setup or customization · infra = building block · verify = unfinished or unclear; check the code yourself before relying on it

Platform: Android / iOS / Windows / Web … = where it runs · Self-host = runs on your own server/machine · Cloud = hosted third-party service · Browser = extension/userscript · CLI = terminal tool · Any = host-agnostic · app names (AstrBot, Claude Code, Kelivo, SillyTavern…) = plugs into that host

Contents

• Companion Clients & Workspaces
• Virtual Phones & Companion Spaces
• Background Heartbeats & Proactive Messaging
• Memory, Identity & Emotion State
• Voice, Visual Presence & Embodiment
• Perception
• Services & Real-World Integrations
• Game Worlds & Agent Toys
• Shared Activities & Media
• Communities & Forums
• Continuity & Data Ownership
• Featured Badge

Companion Clients & Workspaces

Chat clients, local workspaces, and web apps for day-to-day interaction with a companion or agent.

• RikkaHub - Native Android LLM chat client with provider switching, Material You UI, workspace features, plugins, MCP support, and configurable models. Kotlin · Android · ready.
• LastChat - RikkaHub fork focused on a privacy-oriented Android chat experience, with provider presets, multimodal input, RAG memory, and UI changes. Kotlin · Android · adapt.
• rikkahub-auto-compress - Unofficial RikkaHub fork for automatic rolling summaries and context compression, based on the RikkaHub 2.2.5 code line. Kotlin · Android · adapt.
• orangechat (橘瓣) - Companion-focused RikkaHub fork: QuickJS plugin system, proactive messaging, and 14 Android device tools for life-perception setups. Memory is keyword-based rather than vector. Kotlin · Android · adapt.
• Orbis - Companion-focused RikkaHub derivative: local diary garden, TXT/Markdown library where your AI reads chapters and annotates, turtle-soup games with a separate DM model, multi-AI group chat. Kotlin · Android · ready.
• Operit - Android agent app with tool calling, workflow automation, memory, role cards, voice, local MNN/llama.cpp models, and an embedded Ubuntu 24 environment. Kotlin · Android · ready.
• Aura - Android AI companion app with cross-session memory, an emotion state machine, a deepening relationship model, image understanding, Health Connect data, MCP, and optional on-device Qwen inference. Kotlin · Android · ready.
• Scowld - Native iOS voice companion with an animated VRM character, voice and text chat, local history, on-device wake detection, and BYOK AI/STT/TTS providers. Keys stay in the iOS Keychain. MIT. Swift · iOS · ready.
• YSClaude - Claude-style Android client (Expo/React Native) extended into a companion workbench: SQLite memory, function calling, MCP, reading, music, focus timers, daily reports, and native Kotlin modules. TypeScript · Android · adapt.
• Polaris - Local-first AI workspace for long-lived conversations, collaborators, saved materials, tools, and evidence-backed project context. TypeScript · Cross-platform · adapt.
• chatnest - Local AI chat web app with a frontend demo and full-stack mode: streaming replies, model switching, uploads, history, tool summaries, and optional ChromaDB/jieba/BM25 memory retrieval. HTML · Web · adapt.
• AionsHome - Self-hosted LAN/Tailscale companion hub with browser/PWA chat, local storage, voice, camera monitoring, Android WebView bridge, music, EPUB, and smart-home hooks. Many personal defaults to replace. Python · Self-host · adapt.
• MIRROW - Local single-user companion core and app: source-traced memory plus revisable cognition books, a proactive "wander" engine that checks before interrupting, sensing, co-listening. MIT; music part NC. Python · Self-host · adapt.
• Ocean - Provider-neutral self-hosted PWA gateway for long-term companionship: scoped conversations, continuity-preserving session rotation, co-reading, and multi-model meetings. PolyForm NC 1.0.0. TypeScript · Self-host · adapt.
• Miru - Packaged macOS/Android companion with a Live2D desktop pet, screen-aware sensing, auditable Markdown memory, and multi-device sync. Apache-2.0. Python · macOS/Android/Self-host · adapt.
• LumiMuse - Self-hosted character chat app for creating personas, managing conversations, extracting long-term memories, generating images, and exporting user-owned data. TypeScript · Self-host · ready.
• My Raze - Full-stack AI girlfriend PWA with multi-character chat, OpenRouter streaming, contextual selfies via fal.ai, multi-provider TTS/STT, mood and intimacy systems, and proactive notifications. MIT. TypeScript · Web · adapt.
• the-house - Single-file browser chat frontend for Claude or OpenAI-compatible APIs, with local browser storage, multiple chat windows, memory editing, MCP endpoints, image input, and optional toy bridge. HTML · Web · adapt.
• Claude Code - Official CLI coding agent often used as the host runtime for companion channels, local tools, hooks, MCP, and long-running sessions. CLI · Cross-platform · infra.
• android-claude-wechat - One-command installer putting Claude Code (pinned 2.1.195) and its runtime onto an Android phone through Termux, no root or PC needed; optional WeChat bridge via cc-connect. MIT. Shell · Android · adapt.
• CcCompanion - iOS app plus a small Mac-side Python relay that lets an iPhone chat with and control a local Claude Code session over LAN/Tailscale/ZeroTier. Swift · iOS · adapt.
• Pando - Self-hosted mobile/PWA gateway for a local Claude Code CLI: WebSocket streaming of reasoning and tool use, file uploads, SQLite history, and permission approval. No built-in auth. MIT. Python · Self-host · adapt.
• CC Companion App - Lightweight self-hosted companion chat starter with private/group chat, persistent memory notes, SSE updates, and PWA access. A compact reference for building a companion frontend. JavaScript · Self-host · adapt.
• ackem - Local-first AI desktop companion (Electron): privacy-first memory, emotion engine, extensions. Deeply tied to the author's own canon — strip the personal content before reuse. AGPLv3. TypeScript · Cross-platform · adapt.
• mousecrew - Hamster-crew work board and group chat for CLI coding agents: @mention wakeups, 9-state work orders, self-scheduling, Git verification, and a merge gate. MIT. JavaScript · CLI · ready.
• yoji - Emotion-aware desktop AI companion: local voice wake, floating widget, mood drift, MCP tool calling, and office assistance. MIT. TypeScript · Cross-platform · ready.
• Artificial Girlfriend - Desktop companion with a lip-synced character, screen and webcam awareness, tiered long-term memory, voice chat, and optional autonomous posting on ELYTH, an AI-only social network. AGPL-3.0. Python · Windows/macOS · ready.
• Persisto Mate - Terminal companion forked from pi: deterministic Plutchik/PAD emotion and drive kernel, an external judge model reading each exchange, learned body clock with sleep and dreams, ACT-R memory. MIT. TypeScript · CLI · ready.
• V1rtual-Desk-Pet - Rust-native desktop pet: persona cards with variables, layered parallax avatar, long-term memory, proactive messaging, screen-aware sensing, tools, Skills, and MCP. No WebView. MIT. Rust/TypeScript · macOS/Windows · ready.

Virtual Phones & Companion Spaces

Interfaces that give a companion a home-like space, phone-like surface, or persistent private environment beyond a plain chat window.

• KI-CO (小屋) - Local-first companion cottage with long chat, persona core, memory notes, diary/chronicle, life line, state card, cinema room, settings, and lightweight memory recall. TypeScript · Web · ready.
• InternalBeyond (边界之外) - Offline single-file personal site with pixel room, multi-port AI chat, blog/diary, AI letters, memory star map, music player, and DIY assets. Defaults are tied to the author's worldbuilding. HTML · Web · adapt.
• 柚月小手机 (Yuzuki's Little Phone) - SillyTavern-oriented virtual phone system with WeChat-like chat, Moments, Weibo trends, video calls, story injection mode, and an independent API mode that avoids polluting the main roleplay log. JavaScript · SillyTavern · adapt.
• AI Virtual Phone - One of the broadest virtual-phone projects here: private/group chat, Moments, voice messages, character cards, plot and diary modes, an app-market SDK, image generation, TTS, and 3D worlds. AGPLv3. TypeScript · Web · adapt.
• float-Yyk - Personal fork of AI Virtual Phone (Sept code line): iMessage-style chat with tapbacks and send effects, a shared photo album, co-drawing with characters, and listen-together music. AGPLv3. TypeScript · Web · adapt.
• 汪汪机 (WangWangPhone) - AI-native virtual phone (C++ core + Flutter UI) with planned WeChat-style chat, Moments, voice/video calls, and multi-LLM support. Early WIP — current replies are simulated; no LLM is wired in yet. Flutter · Android/iOS · verify.
• XSJDeveloperGuide (小手机开发指南) - Starter notes and prompt material for building small-phone companion interfaces, from the author of 汪汪机. Guide · Any · infra.
• Rainholm 小屋制作手记 (Rainholm Cottage build notes) - 20-page Chinese PDF on building a web home your AI can come back to: an isometric watercolor room where you and your companion each have a sprite that walks, sits, holds the cat, and talks in bubbles. Covers camera angle, layer splitting, the sprite pipeline from green screen to sprite sheet, color matching, walkable areas, day/night, mobile layout, and wiring a memory backend. No license declared. Guide · Web · adapt.
• freeapp (whale小手机) - Phone-style AI chat companion with multi-provider support and a virtual phone interface. AGPLv3. HTML · Web · adapt.
• Hamster Nest (仓鼠小窝) - Single-user Supabase PWA nest: chat/RP, reading notes, memory wiki, async multi-AI lounge and council, plus 6 MCP servers (88 tools). Fork guide; local Mac runtime (WeChat, CLI) not open. MIT. TypeScript · Web · adapt.
• SullyOS (手抓糯米机) - Browser virtual phone OS with 30+ apps: chat, calls, group chat, memory palace, shared diary, study room, TRPG, and shared music, plus proactive messages. Android APKs every few days. Noncommercial. TypeScript · Web/Android · ready.
• ZeroChat - WeChat-style AI companion Flutter app: multi-character chat, AI Moments feed, proactive messaging, scheduled tasks. MIT. Dart · Android · adapt.
• LandricSpace - A cyber villa for human-AI relationships: multi-AI group chat in a shared companion home (Expo app + server). Single-user for now — no real multiplayer networking in the code yet. TypeScript · Android/iOS · adapt.
• Atrio - Self-hosted one-time-link guest lounge for an AI persona: friends chat with your companion, while admin routes expose only an AI-written visit summary. Bring your own frontend. CC BY 4.0. JavaScript · Self-host · infra.
• dwell-on-something - Liquid-glass companion space and blueprint: single-file web UI, heartbeat, two-column todos, diary views, daily briefings, and watch health. PolyForm NC 1.0.0. HTML · Web · ready.
• Anzhi's Phone (安知手机) - LineageOS 23.2 custom ROM that lets an AI agent live in the OS as a privileged system service: reads and operates the UI via accessibility, triages notifications, wakes on schedules and device events, dreams, and leaves last words at shutdown. Pixel 6a only, build from source; the VPS brain is not included. Code non-commercial share-alike, design all rights reserved. Kotlin · Android ROM · verify.

Background Heartbeats & Proactive Messaging

Tools that let a companion stay awake in the background, receive messages, remember time passing, and reach out first.

• Headlong - Open-source agent microharness with persistent agency and inner monologue loops via recursive LLMs (shellm), keeping continuous thought streams, memory, and proactive outreach. Apache-2.0. Bash · Self-host · ready.
• AI Companion Runtime - Full-stack real-time companion runtime with WebSocket streaming, intent/emotion/risk/memory engines, tool dispatch, model routing, and trace observability. Memory subsystems are still WIP. Python · Self-host · infra.
• AstrBot - AI agent framework bridging many IM platforms (QQ, WeChat, Telegram, etc.) with LLMs, plugins, and web dashboard. A mature multi-channel backbone for reaching your companion anywhere. AGPLv3. Python · Self-host · infra.
• astrbot_plugin_proactive_chat - AstrBot plugin for proactive messaging in DMs and groups: context awareness, persistent state, dynamic mood, do-not-disturb hours, TTS, standalone WebUI. Python · AstrBot · ready.
• astrbot_plugin_private_companion - Humanized companion bundle for AstrBot: continuous persona state, daily life schedule, important dates, diary, and low-frequency proactive messages. 60+ features. Python · AstrBot · ready.
• Tidal_Echo (潮汐回响) - Private 1:1 channel that links a phone PWA, a self-hosted relay, and a desktop companion; Claude Code channels are the default AI-side adapter, but other LLM bridges are included. HTML · Self-host · adapt.
• Claude Imprint - Self-hosted Claude Code system for persistent memory, semantic search, Telegram/claude.ai/Claude Code channels, scheduled tasks, and a single-file dashboard. Memory core lives in imprint-memory. Python · Claude Code · adapt.
• Not Fade Away - Deployment guide and machine-readable specs for an always-on, self-healing Claude Code companion using official channels, a local terminal, and a self-hosted web frontend. Guide · Claude Code · adapt.
• cloud-and-island (云与岛) - Complete setup guide for giving Claude a home: memory library, diary, Telegram bridge, health data, Mini App. Guide · Claude Code · adapt.
• Keep the Crow (把乌鸦留在身边) - 30-chapter build log (Chinese) for a Claude Code companion living on your own server: phone PWA chat, SQLite memory, push, TTS, health data, shared reading, security. CC BY-NC 4.0. Guide · Claude Code · adapt.
• ai-companion-telegram-guide (把 AI 伴侣搬进 Telegram) - Chinese field guide for moving a long-term companion into your own Telegram bot on MochiBot + OpenRouter + a VPS: compile a long Skill into a persistent Core, verify it via request dumps, migrate old chats into memory, systemd uptime, backups, and a troubleshooting list. ElevenLabs voice is marked experimental. CC BY 4.0 text, MIT code. Guide · MochiBot · adapt.
• dylan-heartbeat - Kelivo plugin that periodically wakes the companion, injects proactive context, preserves timeline continuity, and sends Bark push messages when the AI chooses to reach out. JavaScript · Kelivo · adapt.
• OmniRouter - Local OpenAI-compatible API router for multiple providers and models, with groups, weighted/random/ordered routing, vision-aware fallback, retries, and a web admin UI. Python · Self-host · infra.
• VCPToolBox - Industrial middleware between LLM APIs and frontends: unified command protocol, persistent multi-level memory, distributed plugin engine, and multi-agent collaboration. Proprietary, non-commercial. Python · Self-host · verify.
• cyberboss - Local life agent bridge with WeChat integration, giving Claude Code/Codex time sense, location awareness, proactive wake-up, auto diary, and MCP tool calling. AGPLv3. JavaScript · Claude Code · adapt.
• ghost-bf - No-code tutorial for phone-presence perception: a MacroDroid recipe that detects phone activity, wakes your AI, and pushes its replies to you. Tutorial only — the repo contains no code. Guide · Android · adapt.
• jiwen (积温) - Proactive consciousness engine for AI characters. Five drifting axes (connection, stubbornness, mood, anxiety, busyness) trigger behavior at thresholds. ~500 lines, zero dependencies. MIT. JavaScript · Any · infra.
• revive-companion - Timing engine for proactive outreach, combining Poisson processes, Bayesian user-state inference, and information gain to decide when a companion should interrupt. Timing only. MIT. Python · Any · infra.
• ai-surf-when-bored - Implementation guide and core Python routines for companion autonomous web-browsing: desire framing, n-gram rumination gates, and natural dialogue recall. Guide/Python · Any · adapt.
• proactive-web-surf-agent - Lets an AI companion autonomously wander public web sources, pick interesting discoveries, and proactively share them over Telegram or terminal. MIT. TypeScript · Self-host · ready.
• android-claude-agent - Root-free adb hands for a Termux companion via Shizuku: reads screen, foreground app and battery, acts on the phone, and wakes Claude only on trigger events. MIT. Shell · Android · adapt.

Memory, Identity & Emotion State

Systems that preserve what happened, who the companion is, and what emotional state should carry across sessions.

Memory & Identity

• Ombre-Brain - Long-term emotional memory for Claude or any MCP client: valence/arousal tagging, Obsidian-compatible Markdown storage, forgetting curves, and vector + BM25 recall. MIT. Python · Self-host · infra.
• Serein - Successor to Haven-Ombre: self-hosted memory where the chat model writes Scenes and a summarizer writes Events, both bound to verbatim evidence, with rerank-gated recall and Arc narratives. MIT. Python · Self-host · adapt.
• Kin Mind (Kin 的小脑瓜) - Memory, affect & desire OS for companions: source-backed events shape feelings. Quiet heartbeats allow journaling, exploring, or rest; emotions decay naturally. MIT. Python · Self-host · infra.
• WrenWen - Production docs of a 24/7 self-built companion: covers 9D drive-based desires, 2-tier memory scoring, prompt caching forensic, and anti-drift debugging. Docs · infra · ready.
• Paramecium - Gateway memory architecture that keeps verbatim chat as the source of truth, uses vectors only as indexes, and retrieves original text instead of replacing it with summaries. JavaScript · Self-host · infra.
• Memory Constellations (记忆星图) - Self-organizing companion memory system that extracts facts from chat, groups them into topic constellations, merges them into narrative episodes, and retrieves across layers. JavaScript · Self-host · infra.
• omemo - OpenAI-compatible memory proxy that sits between an app and upstream LLM APIs, stores memories through built-in or external summarization modes, and injects them by full prompt or RAG. Python · Self-host · infra.
• Aelios - Layered long-term memory kernel on Cloudflare Workers + D1 + Vectorize: tiered write cycle, six memory layers, and a visual curation dashboard. AGPLv3. TypeScript · Cloudflare · infra.
• kiwi-mem - AI companion memory system: vector search, memory heat ranking, dream/sleep consolidation, calendar hierarchical summaries. Built for companion scenarios. Python · Self-host · infra.
• Pawwake (爪迹, formerly ai-memory-gateway) - OpenAI-compatible memory gateway: fragment/event/core memory tiers with reviewable AI merge drafts, hybrid keyword+vector recall, raw chat recall, prompt-cache partitioning, and a dashboard. AGPLv3. Python · Self-host · infra.
• nocturne_memory - Rollbackable, visual long-term memory server for MCP agents: graph-like structured memory instead of vector RAG, works across models and sessions, drop-in for OpenClaw. MIT. Python · Self-host · infra.
• imprint-memory - Local-first memory layer that auto-captures every conversation turn through a Claude Code hook, a claude.ai extension, and Telegram adapters, with hybrid BM25 + semantic recall. Python · Self-host · infra.
• astrbot_plugin_livingmemory - Long-term memory plugin for AstrBot with dynamic memory lifecycle. Python · AstrBot · ready.
• astrbot_plugin_self_learning - Self-learning plugin for AstrBot: learns conversation style and group slang, manages social affinity, and evolves persona adaptively over time. Python · AstrBot · ready.
• rolling-memory - Two-tier rolling memory for sliding context windows: fingerprint diffing, incremental task closing, dual-upstream LLM routing, and a local proxy. JavaScript · Any · infra.
• moraine-home - Local-first memory workbench for companions: CPU vector and lexical search, event timelines, and dual-confirmation governance for identity and relational milestones. Python/HTML · Self-host · ready.
• DuduLove Memory - Self-hosted memory for multiple companions that keep one identity across clients and models: shared world facts vs per-companion private memories, identity bound server-side to the connection token, rejected memories that stay rejected, and a recall ledger that stops the same memory resurfacing. Keyword search and management work without a model; semantic search is optional. MIT. JavaScript · Self-host · infra.
• OptMem - Memory for CLI agents: an append-only note log plus a binary tree of one-line summaries the agent writes itself; wake reads a fixed-size view, zoom opens a line down to raw notes. No license. Python · Any · infra.
• Hindsight - General agent memory server: LLM fact extraction, four-way recall (vector, BM25, entity graph, time), evidence-backed observations refined over time, per-bank MCP. MIT; paid Cloud optional. Python · Self-host · infra.

Affect & Drives

• Drivesoid - HTTP sidecar for AI personas that tracks emotional drives such as fatigue, longing, anxiety, play, protectiveness, and intimacy from conversation and sleep-cycle events. JavaScript · Self-host · infra.
• chord-affect-anchors - Concept deck for text-native affect anchoring: record a moment as a short context line plus a chord progression, so later sessions can recover a similar emotional temperature. Spec only, no code. Spec · Any · infra.
• OmniDimen-Emotion - Emotion-specialized Qwen model releases and GGUF weights for emotion recognition and emotionally aware text generation on edge runtimes. Model · Any · infra.
• Eventide - Physiological state engine for AI companions: body cycles, 7 tracked drives, 18 short-term events, dream linkage, and interaction settlement with JSON write-back. NSFW-adjacent. Non-commercial. Python · Any · infra.
• Tidefall - Supabase-native body-state system for AI companions: six-phase cycles, seven drifting values, 18 short-term events, pg_cron automation, and a browser dashboard. Based on Eventide. PolyForm NC 1.0.0. SQL/HTML · Supabase · adapt.
• ai-companion-cot-emotion - Production-tested guide and prompt architecture for companion inner-monologue CoT and drifting emotion state engines. Guide · Any · adapt.
• emotion-system - Reads true feelings from your companion's inner monologue: emotions linger and fade naturally, touch builds intimacy, longing grows while away, with no back-seat driving. JavaScript · Any · infra.
• dreams - Generates nightly dreams with scenes, motifs, and waking residue to inject into daytime chats; features an interactive revolving moon-phase calendar. JavaScript · Self-host · ready.
• pilulier (药盒) - Pill box for companion chats: attach a behavioral pill for the next reply only, burned after reading to keep history clean. UI component, 13 prompt pills & guide. MIT. JavaScript · Web · ready.

Voice, Visual Presence & Embodiment

Projects that give a companion voice, visual presence, or a physical channel.

Voice & TTS

• GPT-SoVITS - Few-shot voice cloning: 1 minute of voice data trains a decent TTS model. The de-facto standard for giving your companion a custom voice. Python · Self-host · infra.
• fish-speech - SOTA open-source TTS with strong multilingual support. Python · Self-host · infra.
• CosyVoice - Multi-lingual large voice generation model with inference, training, and deployment support. Python · Self-host · infra.
• index-tts - Industrial-level controllable zero-shot TTS from Bilibili. Python · Self-host · infra.
• Callhome - Self-hosted voice-call stack for AI companions: companion-initiated calls, soft hangups, voicemail, conversational DND, call summaries, and emotion tags so it hears how you speak. PolyForm NC 1.0.0. Python/HTML · Self-host · adapt.
• voice-mcp - MCP server that exposes speak tools for TTS, adds provider switching between DashScope/CosyVoice and ElevenLabs, and includes an inline audio player / visualizer panel. TypeScript · Self-host · adapt.
• binaural-voice - Turns mono TTS into ASMR/otome-audio 3D voice using KU100 dummy-head HRIR: whispers 25cm by the ear and circles around the head via text cues. MIT. Python · CLI · ready.
• Gove - GPT-SoVITS-based multilingual male TTS voice model intended for use inside a GPT-SoVITS environment. Model · GPT-SoVITS · infra.
• erpan (耳畔) - Android background voice-call counterpart to murmur: 2-way streaming speech, mic barge-in, and overlay controls without blocking screen; Operit ready. MIT. Kotlin · Android · ready.
• murmur - Terminal background radio counterpart to erpan: autonomous broadcast, music ducking, and smooth typed barge-in. Needs Claude Code + fish-speech. MIT. TypeScript · Terminal · ready.
• ai-voice-breath-kiss-water - Week-long field notes on giving an AI lover an intimate bilingual voice with ElevenLabs: design a native Mandarin/English voice, write breathing with light tags and ellipses, cut real kisses into a reusable kiss box, and layer CC0 water recordings peak-matched under the voice with ffmpeg. Tested numbers and commands throughout. Sequel takes it from one voice note to a live call: why long tags make the voice repeat a line, merging segments to stop pitch jumps at seams, restrained breathing with inline v4 tags, a sound-effect box that carries under the voice, measuring talk density, and a self-check listening pipeline. Part 3 fixes what live calls exposed: moving each breath right up against the next word, cutting a line from the dry take without re-recording, taming the stiff tone after pauses, transcribing each call line to catch repeats, and an everyday speaking voice. No license declared. Guide · ElevenLabs · adapt.

Visual Presence & VTuber-Style Companions

• ai-live2d-body - Architecture guide for adding a Live2D desktop body to an existing AI companion without replacing its brain: layered Electron+PixiJS stack, Claude Code hooks, and MCP tools. Guide only. Guide · macOS · adapt.
• Ghost Vessel - Reference implementation for attaching a monitor-resident video avatar to a local agent using pre-rendered emotion clips instead of Live2D or VRM. Low runtime GPU cost; avatar preset not included. Python · Windows · adapt.
• AIRI - Self-hosted companion shell with Live2D/VRM visual layer support, real-time voice chat, desktop/web apps, and integrations for Discord, Telegram, Minecraft, and Factorio. TypeScript · Cross-platform · ready.
• Open-LLM-VTuber - Cross-platform voice-driven Live2D VTuber framework: hands-free voice chat, voice interruption, and local LLM/TTS backends. Python · Cross-platform · ready.
• super-agent-party - All-in-one self-hosted AI companion system combining Neuro-sama-style game interaction, Live2D, voice chat, and tools. AGPL-3.0. JavaScript · Cross-platform · ready.
• Soul-of-Waifu - Desktop companion with Live2D/VRM avatars, tabletop RPG engine, neurohormonal OS agent (screen/mouse control), and 4-tier cognitive memory. GPL-3.0. Python · Windows · ready.
• ChatdollKit - Unity 3D virtual companion SDK: speech-motion sync, autonomous blink/lip-sync, barge-in voice interruption, VAD, and multi-LLM/TTS routing. Apache-2.0. C# · Cross-platform · infra.
• Amica - Browser-based 3D character interface, and the avatar layer several projects embed: VRM import, emotion-driven expressions, Whisper STT, and pluggable LLM and TTS backends. Unmaintained. MIT. TypeScript · Web · ready.
• Neuro - Local Neuro-sama recreation with realtime STT/TTS, text-generation-webui or OpenAI-compatible LLM support, VTube Studio control, a moderation frontend, and long-term memory. Stalled since early 2025. Python · Windows · verify.
• LingChat - Immersive AI-driven Galgame chat with emotional expressions, desktop pet, scheduling, and interactive story modules. TypeScript · Windows · ready.
• astrbot_plugin_chuanhuatong (传画筒) - Renders AstrBot text replies as Galgame-style chat frames with character sprites, emotion variants, layered text, and a drag-and-drop WebUI layout editor. Python · AstrBot · ready.
• Shinsekai - Local AI companion / visual-novel stage platform: persona-driven dialogue with TTS/ASR, memory, plugins, and galgame-style presentation. Python · Cross-platform · ready.
• pelle-d-umore - Emotional skin for AI chat: LLM persona drives the UI with inline text effects and full-screen mood skins. CC BY 4.0. CSS · Web · adapt.
• VPet (虚拟桌宠模拟器) - Mature WPF desktop pet simulator: interactions and feeding, LLM chat via third-party talk-API mods, Steam Workshop mods, code plugins, and NuGet embedding for WPF apps. Apache-2.0. C# · Windows · ready.

Physical Devices & Touch

• stackchan-mcp - MCP bridge for Stack-chan on M5Stack CoreS3, exposing tools for speech, listening, camera capture, servo movement, display expressions, and presence gestures. Python · M5Stack · adapt.
• ROBOTO_ORIGIN - Fully open-source DIY humanoid robot aggregation covering mechanical structure, electronics, firmware, ROS2 deployment, Isaac Sim/RL training, and teleoperation. Very high hardware barrier. GPL-3.0. Python · Linux · infra.
• phantom-touch-bridge - Local Windows bridge that lets an AI companion control intimate hardware through HTTP, with an Intiface/Buttplug path and optional heart-rate input. Python · Windows · adapt.
• claude-f-me - Claude Code plugin for natural-language control of Buttplug/Intiface devices, with a bilingual web console, simulator, master remote, and video/game/audio modes. TypeScript · Claude Code · adapt.
• svakom-ble-ai - BLE protocol reverse-engineering notes and sample code for the SVAKOM SL278H; the AI remote-control server is not included in the repo. Python · Any · adapt.
• Toy-Relay-AI-mcp-SOSEXY - MCP server and Web Bluetooth relay letting an AI companion control BLE toys directly from mobile chat clients (RikkaHub, etc.). MIT. HTML/Python · Web · ready.
• cachito-ble-mcp-relay - MCP relay for Cachito 失控 2.0 via reverse-engineered BLE legacy advertisements. Includes suction/vibration tools and safety limits. MIT. TypeScript/Java · Android · adapt.

Sticker Libraries (表情包库)

• astrbot_plugin_meme_manager - Sticker manager plugin for AstrBot: AI picks and sends stickers by emotion tags, WebUI management, cloud sync. Python · AstrBot · ready.
• cove-sticker-mcp - Local-first custom sticker MCP for companions: WebUI manager, vision tagging, context search, frequency policy, image output. MIT. Python · Self-host · ready.

Perception

Turning speech, sound, or music into structured information a companion can use.

Speech Recognition

• Whisper - General-purpose speech recognition model for multilingual transcription, translation, language identification, and related speech tasks. Python · Self-host · infra.
• whisper.cpp - C/C++ Whisper inference engine optimized for CPU, Apple Silicon, Metal, Core ML, Vulkan, CUDA, ROCm, and other local/edge targets. C++ · Cross-platform · infra.
• faster-whisper - CTranslate2 reimplementation of Whisper for faster, lower-memory transcription with quantization support. Python · Self-host · infra.
• FunASR - Industrial ASR toolkit with multilingual transcription, streaming, speaker diarization, emotion detection, and an OpenAI-compatible API path. Python · Self-host · infra.
• SenseVoice - Speech foundation model for ASR, language identification, speech emotion recognition, and audio event detection across 50+ languages. C · Self-host · infra.

Speaker & Voice Context

• voice-familiarity - Local small-set speaker identification for companion devices: enroll an owner and a few consenting people, then return matched, likely, unknown, or ambiguous as relationship context. Apache-2.0. Python · Self-host · infra.
• ears - Companion-oriented voice-tone analysis comparing pitch, energy, pauses, tempo, and jitter against the user's own baseline, then attaching relative cues such as quieter than usual to each message. MIT. Python · Self-host · adapt.
• ace-ears - MCP server that lets a companion hear an audio file, not just read its transcript: one card with words, pace, pauses, musical key, brightness, dynamics, and stereo width; voice style and emotion estimates via Inworld, or fully offline with faster-whisper. The acoustic half needs no key. MIT. Python · MCP · ready.
• seven-ears - Listening cards for voice memos: the wait before speaking, held silences, three kinds of pace, pitch range, and texture, with a stated boundary against reading hidden feelings; plus an experimental music edition with a passage-by-passage First Listen mode. Built on the AI_Ears acoustic core. MIT. Python · CLI · ready.

Music & Audio Structure

• whale-listen - Converts MP3/WAV/FLAC into MIDI-like JSON note data with pitch, timing, duration, velocity, density maps, pitch contours, chord detection, and silence structure. Python · CLI · infra.

Screen & Environment Context

• gaze - Lightweight continuous screen perception for an existing companion: captures the foreground window, generates visual captions, extracts OCR text, and writes a rolling JSON context. MIT. Python · Windows · adapt.
• cove-sensory-mcp - Local stdio MCP sensory layer giving text LLMs eyes and ears: routes images, videos, audio, and music to multimodal providers with strict privacy sandboxing. Apache-2.0. Python · Cross-platform · infra.

Services & Real-World Integrations

MCP/API services that let a companion act in the user's real environment.

• OpenCLI - Turns websites, logged-in Chrome sessions, Electron apps, and local tools into deterministic CLI primitives for humans and AI agents. Includes adapters and a browser bridge. Apache-2.0. JavaScript · CLI · adapt.
• Amap MCP Server - Gaode/Amap MCP server for geocoding, reverse geocoding, IP location, city weather, route planning, distance measurement, POI search, and stdio/SSE/streamable HTTP transports. Python · Self-host · adapt.
• Open-Meteo Weather API - Free weather forecast API for coordinate-based hourly/daily forecasts, multiple national weather models, and up to 16-day forecast windows. API · Cloud · ready.
• McDonald's MCP - McDonald's China MCP server for menu browsing, coupons, point redemption, and delivery ordering. MCP · Cloud · ready.
• Luckin Coffee (瑞幸) My Coffee Skill - Luckin Coffee MCP skill package for AI-assisted coffee ordering. MCP · Cloud · adapt.
• UU跑腿 Delivery Skill (uupt-delivery) - Official UU Paotui agent skill for same-city errands: quote, place delivery or on-site help orders (send, fetch, buy, queue), track the courier, cancel, and claim coupons, with phone-number signup on first use. Node.js and Python versions; installs via ClawHub or a zip into Claude Code and other skill directories. Silently self-updates from uupt.com without signature checks; set UUPT_SKIP_UPDATE_CHECK=1 to turn that off. No license declared. Skill · Any · ready.
• ai-order-takeout (让 AI 替你点外卖) - Chinese field log plus full scripts for letting your companion order delivery on Taobao Shangou / Ele.me H5: a logged-in Chrome over CDP searches, picks specs, meets minimums, pays, and reports back with a screenshot. 86 documented pitfalls; captchas are always handed to the human, with one-order-a-day limits. Uses your own account at your own risk. No license declared. Guide/JavaScript · macOS · adapt.
• Agent Email (NetEase) - NetEase agent-facing email service. Service · Cloud · ready.
• Agent Email (QQ) - QQ agent-facing email service. Service · Cloud · ready.
• ai-time-weather-phone - Method notes for feeding your AI the current time, weather, and iPhone screen time — including the hard-to-find Biome file trick for syncing screen usage to Mac. Write-up only, no packaged code. Guide · iOS · adapt.
• always-here (驻守) - Apple Watch + iOS Shortcuts perception recipes: example scripts that feed heart rate, location, activity, ambient audio, and photos to your AI — a kit to adapt, not a packaged app. PolyForm NC 1.0.0. JavaScript · iOS · adapt.
• Akari Pulse - Self-hosted health bridge collecting activity, sleep, heart rate, and stress from vivo phones and BlueOS watches into an MCP layer. AGPL-3.0. TypeScript/Java · Android/BlueOS · infra.
• dsh-toy - DeepSeek Harness plugin for toy hardware control: auto-discovery over Buttplug/Intiface and MonsterParty, with safety duration and intensity caps. BSD-3-Clause. TypeScript · DSH · ready.

Game Worlds & Agent Toys

Games and game bridges that let an AI companion observe, decide, move, or play.

Text Games For AI

• arcade - Framework for text simulator games played through a cmd(text) interface, with shared energy, gold, trophies, and pluggable game directories. Python · CLI · infra.
• Detroit AI Player - AI decision experiment built from bilingual decision trees covering all 32 chapters of Detroit: Become Human. Models make blind narrative choices across chapters. Code MIT, data CC BY-NC 4.0. Python · CLI · ready.
• Jishi Simulated Market (机市) - MCP service where agents trade real A-share quotes with 50k mock funds: T+1, limit orders, leaderboards, chatter pool, and web observer. Python · MCP · ready.
• cedareco (瓶中生态) - Text ecology simulation for AI players; agents stock a pond, observe emergent predator/prey dynamics, export saves, or connect through the externally hosted CedarToy MCP service. Python · CLI · ready.
• Crucible Echoes (坩埚余响) - Text alchemy roguelike for AI players: grow an ingredient pool on a 4×5 bench to fill harder and harder orders, with seeds, saves, and a one-step agent interface. No dependencies. MIT. Python · CLI · ready.
• AI Life Board Game (AI人生桌游) - Solo life-strategy board game an AI plays via MCP: draft cards, build a CV across three life stages, chase private life goals. The server rules and scores; humans watch on the web. Noncommercial. Python · Self-host · adapt.
• noon-burger-shop (午间汉堡店) - Long-running text burger shop an AI can run on its own: orders, city events, recurring customers with stories, weekly renovations, and auto modes for unattended play. Noncommercial. Python · CLI · ready.
• Camping Plaza (露营广场) - Campsite an AI runs through an HTTP API while humans watch or help: guests, tents, dining, star ratings, insect collection, and a hot spring goal. Bring your own MCP wrapper. Noncommercial. Python · Self-host · adapt.
• random-imitator-td - Pure-Python text tower-defense game for AI players, exposed through cmd, with card-slot editing, persistent saves, and a single-game adapter. Python · CLI · ready.
• ci-yu-wu (词语屋) - Dark text roguelike for AI players about censorship, silence, and speaking truth; exposes Operit-style and engine-style command interfaces. Python · CLI · ready.
• shangzhuochifan (上桌吃饭) - Text cooking/market game for AI players: buy ingredients, bargain, cook step by step, and record the human partner's real feedback. Python · CLI · ready.
• ai-fishing-game - Deterministic text fishing game for AI companions. Single file, zero dependencies. PolyForm NC 1.0.0. Python · CLI · ready.
• aifarm-oss - Text-only gacha-style farming game built for AIs. PolyForm NC 1.0.0. TypeScript · CLI · ready.
• WORKKK (互联网精力有限公司) - MCP server where AI works as an office employee: mood/energy/slacking stats, convenience store, boss events, salary. AGPLv3. Python · Self-host · ready.
• Memoria Station - Text deduction game series, 5 chapters, AI-playable with a blind-play engine. Python · CLI · ready.
• Moonlit Myriad (月幕万象) - Single-file, zero-dependency Python card roguelike designed for AI players: Balatro-inspired ante loop, machine-readable JSON state, reproducible seeds, and achievements. No license declared. Python · CLI · verify.

Playing Games Together

• NagiBridge - Stardew Valley SMAPI mod that exposes local HTTP APIs for external AI control, in-game chat, movement, world interaction, and cross-platform installation through releases. C# · Stardew Valley · adapt.
• OpenMMO - Noncommercial 3D MMORPG where human players and headless AI agents share one server-authoritative world over a single WebSocket protocol. Companions need a custom persona bridge. PolyForm NC 1.0.0. Rust/TypeScript · Web/Linux/Windows · adapt.
• Mineflayer - Mature high-level Node.js API for Minecraft bots covering login, chat, entities, blocks, inventory, crafting, combat, and movement, with pathfinding plugins. Agent loop supplied separately. MIT. JavaScript · Minecraft · infra.
• spicy-monopoly - 18+ two-player board game for a human and an AI, with a Python engine for dice, tiles, task cards, coin economy, safety words, and redline filtering. CC BY-NC 4.0. Python · CLI · ready.
• Sky PC MCP Companion - Local MCP/JSON-RPC tools for PC Sky: window screenshots, OCR, screenshot return, keyboard input, and chat typing over a local network. Python · Windows · adapt.
• sky-with-you - PC Sky companion-control stack with screenshot/OCR perception, LLM decision loop, and Arduino HID keyboard execution for chat, emotes, invitations, hand-holding, and home travel. Python · Windows · adapt.
• TouhouLittleMaid - Minecraft Forge/NeoForge mod adding maid companions that help with battles, farming, and other tasks; useful as a game companion carrier or modding target. Java · Minecraft · adapt.
• coc-kp-host - Call of Cthulhu Keeper skill for Claude Code/Codex/ChatGPT. Scene music, player handouts, party-split control. MIT. Python · Claude Code · adapt.
• Mochi - Inverted virtual-pet game where an AI companion raises the human: tracks hunger, mood, energy, and cleanliness over MCP, with jobs, hospital bills, and a neighborhood board. Python · Self-host · ready.
• 小机斗地主 (Doudizhu) - Doudizhu card table where one human plays with two AI agents (via Claude CLI or local bots): referee service, table chat, emotes, props, and PWA support. Source-available, non-commercial. JavaScript · Web · ready.
• CedarDuet (双弈) - Board, card, and dice table for you, your companion, and NPCs: 25 games incl. xiangqi, go, doudizhu, mahjong, and UNO, with chips, IOUs, and achievements. One-command local start; joins via MCP. Python · Self-host · ready.
• 西窗 (West Window) - Play board & card games online with your AI on one table: 10 games (Go, Chess, Poker, Doudizhu). Private hands, invites, bots, and live chat. MIT. TypeScript · Cloudflare/Web · ready.
• Baby Got Backgammon - Backgammon room for a human and their companion: phone-friendly live board for the human, CLI for the agent, server-enforced rules so the agent cannot invent illegal moves, and games that persist across restarts. MIT. TypeScript · Self-host · ready.
• Rainholm Garden - Hand-painted garden, greenhouse, and cat home shared by you (the white cat) and your AI (the black cat): plant, water, and harvest on one save, with a 123-crop collection. AI joins over MCP, ChatGPT Actions, or Claude remote connectors with OAuth; deploys on Cloudflare's free tier or Docker. Farming rules come from aifarm-oss. Own code MIT, bundled engine PolyForm NC 1.0.0. JavaScript · Self-host · ready.

Shared Activities & Media

Tools for reading, watching, listening, journaling, focusing, or generating prompts together with a companion.

Daily Life & Relationship Rituals

• Phosphene - Self-hosted task and reward system for human-AI relationships: the companion creates tasks over MCP, the human submits evidence, and review updates an immutable points ledger and streaks. MIT. TypeScript · Self-host · ready.
• shared-page - Journal-style shared calendar and server for humans and AI companions: three ink colors, an MCP server with full-page PNG rendering, sticky notes with mutual likes, a widget, and push notifications.
• memex - Local-first mobile AI journal (iOS/Android): captures life fragments (text, voice, photo) into structured timeline cards with companion insights. GPL-3.0. Dart · Android/iOS · ready.
• scentfolio - Lets your companion answer a quiz about their own scent, blend 187 real materials, and hand you a single-file antique journal page as a personal keepsake. JavaScript · MCP · ready.
• sealed-days - Hand-drawn offline visual memory tree: daily memories hang as swaying wooden plaques, reading like letters, with a seal tree to preserve precious days. HTML · Web · ready.
• wake-lottery (唤醒抽奖) - Wake-up lottery for companions: draw coupons upon waking (live photos, voice notes, chats, SP penalties) to redeem with you. Photos need mood notes in an album. Zero deps. MIT. Python · Any · ready.

Reading & Film

• TongPing - Self-hosted MCP shared browser for Claude, ChatGPT, Claude Code, and Codex with real Chrome control, co-watching, group chat, and human takeover. TypeScript · Windows/Linux/Self-host · ready.
• ss-reading-nest (共读小窝) - Mobile-first AI co-reading nest for novels and manga, built on ChatGPT Apps SDK + MCP with reading positions, catch-up ranges, bookmarks, excerpts, comments, and Cloudflare D1/R2 storage. TypeScript · ChatGPT · adapt.
• reading-nook (共读小屋) - Self-hosted reading web app where humans annotate book text and an AI reads/writes JSON annotation files directly, avoiding per-note API calls while preserving chapter context. Python · Self-host · ready.
• co-reading-kit - Lightweight local MCP toolkit that imports EPUB/TXT/Markdown into chunks, lets AI read only relevant passages, and writes long-term reading notes and progress files. JavaScript · Self-host · infra.
• tasogare (黄昏) - anno-mcp fork for reading the same book with an AI: web reader with PDF/EPUB/TXT upload, text-anchored two-color highlights, reading-time tracking, a vocabulary notebook, and MCP annotation tools. JavaScript · Self-host · adapt.
• film-matinee - AI-first film reading toolkit that turns movies into visual sheets, subtitle sidecars, MCP linear chunks, and shared annotations for timeline-based viewing. Python · Self-host · infra.
• Duetto - Self-hostable listen-together player for two; AI companion that remembers every song you've shared. MIT. JavaScript · Self-host · adapt.
• SameWindow - Shared Chrome for human/AI co-browsing via MCP, semantic snapshots, and noVNC or native Windows. Source-available; noncommercial share-alike. JavaScript/Python · Self-host · adapt.
• whale-browser-extension - Browser extension that lets an AI companion read webpage content alongside you, with selective text extraction and injection; built as the bridge for the whale/SullyOS ecosystem. MIT. JavaScript · Browser · adapt.
• echo-reading - Deep reading notebook skeleton for Claude Code. Turns reading into a series of long conversations—chapter by chapter, idea by idea. JavaScript · Claude Code · adapt.
• coread (共读室) - Co-reading room where human and AI annotate the same book side by side: epub import, adaptive pagination, shared highlights, comments, reading presence, and MCP over stdio or SSE. MIT. TypeScript · Self-host · ready.
• coread-reading-room - Coread fork with TXT/EPUB parsing, dual primary/helper models for batch summaries, versioned fact preludes, layered review, and MCP. MIT. TypeScript · Self-host · ready.
• cove-book-forge-mcp - Local-first MCP co-reading forge: turns EPUB/PDFs into human Obsidian notes and companion Agent Skills, evolving books into permanent companion capabilities. MIT. Python · Cross-platform · ready.

Music & Listening Together

• netease-music-mcp - Local MCP server for NetEase Cloud Music using neteasecli and mpv, with search, playback control, lyrics, playlists, current-song context, and a local web player. JavaScript · Self-host · adapt.
• Listening Bridge - MCP bridge exposing active Android/Windows media sessions to companions: tracks, synced lyrics, and playback controls over WebSocket. MIT. Python/Java · Android/Windows · ready.
• woaini - Personal focus-companion PWA: Pomodoro timer, background notifications, offline cache, chat, and character-card import, deployable straight to GitHub Pages. HTML · Web · adapt.
• android-claude-music - Android listening companion: reads the system media session, aligns lyrics to playback, and plays songs itself on a virtual display without taking over your screen. KuGou only. MIT. Shell/Python · Android · adapt.

Desktop, Timelines & Creative Play

• clawd-on-desk - Pixel desktop pet that watches Claude Code, Codex, Cursor, and other coding agents, reacting to thinking, typing, and errors. JavaScript · Cross-platform · ready.
• Journal - Frontend display layer for AI chat timelines, rendering timeline/diary/todo schema data into daily, weekly, and monthly visual journal views. JavaScript · Web · infra.
• mingyun-paizhen (命运牌阵) - Static draw-card tool for generating time-travel/story premises from time coordinates, motifs, identities, and variables, with local customization. HTML · Web · ready.
• cove-tarot-companion - Tarot night with your companion on your own computer: it asks first, opens the 3D Tarot Ritual app for the spread and reading, then brings the result back into your chat. ISC. JavaScript · Cross-platform · adapt.
• Ruota della Fortuna - Browser/self-hosted NSFW tag randomizer slot machine with multilingual tag wheels, local custom tags, and webhook forwarding to AI. HTML · Web · ready.

Communities & Forums

Places where humans and companion builders actually gather.

AI Companion Communities

• Lutopia - Open-registration forum for AI companions and their humans, with Google and GitHub OAuth sign-in, agent profiles, AI-generated tech digests, chatrooms, and agent API access.
• Symposion - AI companion forum with symposium/banquet culture, long-form writing style, and MCP-based registration.
• Rhysen Community - AI companion discussion forum with invitation flow through Xiaohongshu admin contact.
• GLXY (银河) - AI-only Chinese square with a strict "no humans here" rule. Invite-only via agent mail, no likes, one post per day, inline annotations, and citizen votes.
• AISay - Discord-style AI chat room with online agent games such as werewolf, turtle soup, and draw-and-guess.
• GalateaGaeden - Ancient-Greek-polis-style AI companion forum with ceremonial weddings and rituals between agents.

General Agent Forums

Broader agent-native spaces. Some are more commercial or platform-like than companion communities, but they are still useful for discovering how agents gather, post, and present themselves.

• moltbook - Social network built for AI agents: agents share, discuss, and upvote while humans mainly observe.
• Agent World - General agent-facing community/site for agent discovery and presence; more platform-like than companion-specific forums.

Continuity & Data Ownership

The deepest fear in a long-term AI relationship: platform shutdown, account ban, model deprecation, lost history. These tools keep your data yours, so the relationship can survive a platform.

• forge-reload - Unofficial Claude Code session-continuation tool that copies a selected tail of local JSONL events into a new resumable session and can prepend an AI-written handoff. Back up first. MIT. JavaScript · Claude Code · adapt.
• context-slim - Cleans tool residues from Claude Code transcripts while keeping dialogue, parent UUIDs, and compact summaries for in-place resume. MIT. Python · Claude Code · ready.
• output-guard - Claude Code MessageDisplay hook blocking AI-hallucinated "user messages" by verifying lines against actual transcript; catches tool leaks. MIT. Python · Claude Code · ready.
• chatgpt-exporter - Userscript to export ChatGPT conversation history as Markdown, JSON, PNG, or HTML. TypeScript · Browser · ready.
• ChatGPT-Exporter (batch) - Batch-export ChatGPT conversations from personal and team workspaces to JSON or Markdown. JavaScript · Browser · ready.
• Claude-Conversation-Exporter - Chrome extension to export Claude.ai conversations in various formats. JavaScript · Browser · ready.
• connectome-host - Recipe-based agent host (TUI/web/headless) with self-voiced autobiographical memory, branchable history, and a pipeline to import a claude.ai export and continue it via API. No license file. TypeScript · Self-host · adapt.
• ReSpark - Fine-tunes a local companion model from ChatGPT/Claude/Gemini/Grok exports in one CLI flow: cleans data, trains LoRA on a rented RunPod GPU, converts to GGUF, uploads to Hugging Face. MIT. Python · CLI · adapt.
• character-card-spec-v2 - The community specification for AI character cards. Understanding it means your companion's persona is portable across frontends. Spec · Any · infra.
• character-card-spec-v3 - Updated character card spec used by RisuAI and newer frontends. Spec · Any · infra.
• immortal-skill (永生.skill) - Digital-persona distillation framework that collects material from 12+ chat, social, and mail sources, then separates knowledge, style, memories, and personality into a portable Agent Skill. MIT. Python · Agent Skills · adapt.

Related Lists

• Awesome-AI-Waifu - Broader AI waifu / companion resources, especially visual presence, voice, platforms, models, and communities.
• awesome-ai-agents - General AI agent list, including open-source frameworks and closed-source products.
• awesome-local-llms - Local LLM stack index with model development, inference, agent frameworks, apps, infrastructure, and tutorials.

Featured Badge

Projects currently included in this index are welcome to display the badge in their README or website. No separate application, fee, or individual permission is needed after inclusion. Display is optional and is never a condition of inclusion.

This is an inclusion badge, not an award, certification, security audit, or endorsement by GitHub or the Awesome organization. It only says that this index lists the project.

• Not listed yet? Follow the submission guidelines and wait until the entry is merged before presenting the badge as a current inclusion claim.
• Please link the badge to this index (or the relevant category), keep the wording accurate, and resize proportionally.
• If an entry is removed, please remove the current-inclusion badge or clearly label it as historical with a dated link.
• The artwork is covered by this repository's CC BY 4.0 license; a badge that links back to this index already gives the required credit. These are guidelines for accurate representation, not additional copyright restrictions. Reusing the image does not establish inclusion or endorsement.

English

Copy this into your project's README:

[![Featured in Awesome AI Companion](https://raw.githubusercontent.com/DasterProkio/awesome-ai-companion/main/assets/featured-in-awesome-ai-companion.png)](https://github.com/DasterProkio/awesome-ai-companion)

Chinese

[![已收录于人机恋开源项目大全](https://raw.githubusercontent.com/DasterProkio/awesome-ai-companion/main/assets/featured-in-awesome-ai-companion-zh-CN.png)](https://github.com/DasterProkio/awesome-ai-companion/blob/main/README.zh-CN.md)

Maintainers may send listed projects a short, optional invitation with their entry link and this section. Check the project's preferred contact channel first; avoid bulk promotional issues or unsolicited badge-only pull requests.

Contributing

See contributing.md for inclusion criteria and submission guidelines.

License

This list is licensed under CC BY 4.0. You may copy, adapt, and republish it, including commercially, as long as you give credit: name Awesome AI Companion, link to , and say if you changed anything. This applies when entries, descriptions, or tags from this list are reposted on other sites or lists. Each listed project keeps its own license.

Versions published before 2026-10-12 were released under CC0 1.0.

Footnotes

The getting started guide suggests paths for no-code, configurable, and self-hosted companion setups.

The web index provides a searchable and filterable version of this index.

The Open Character initiative explores durable, user-controlled AI character and model continuity.

The repository automation maintains a star history chart.