what is ai-virtual-phone fr?

xiaolongbao0709/ai-virtual-phone — explained in plain English

Analysis updated 2026-05-18

★ 258TypeScriptAudience · generalComplexity · 3/5LicenseSetup · moderate

vibe map

mindmap
  root((AI Virtual Phone))
    What it does
      Simulated phone interface
      Chat with AI characters
      Story and roleplay modes
    Tech stack
      Next.js
      TypeScript
      Supabase
    Use cases
      Private and group AI chat
      Character and world creation
      Custom mini apps
    Audience
      General users
      Roleplay enthusiasts
    Requirements
      Bring your own LLM API key
      Optional Supabase for cloud features

mindmap root((AI Virtual Phone)) What it does Simulated phone interface Chat with AI characters Story and roleplay modes Tech stack Next.js TypeScript Supabase Use cases Private and group AI chat Character and world creation Custom mini apps Audience General users Roleplay enthusiasts Requirements Bring your own LLM API key Optional Supabase for cloud features

what do people make with this?

VIBE 1

Chat privately or in groups with an AI character that remembers past conversations.

VIBE 2

Build a custom AI character using character cards, a lore book, and presets.

VIBE 3

Play through a visual novel or map based story mode with your AI character.

VIBE 4

Build and publish a custom mini app for the app marketplace using the included SDK.

what's the stack?

TypeScriptNext.jsSupabase

how it stacks up fr

	xiaolongbao0709/ai-virtual-phone	razr001/align-dev	ni5arga/deanonymizer
Stars	258	257	255
Language	TypeScript	TypeScript	TypeScript
Setup difficulty	moderate	easy	moderate
Complexity	3/5	2/5	3/5
Audience	general	developer	developer

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires your own LLM API key, optional features like image generation, music, and accounts need separate API keys or a Supabase project.

AGPL-3.0: you can use and modify it freely, but if you run a modified version as a network service, you must share your source code changes.

in plain english

AI Virtual Phone is a web app, built with Next.js, that simulates a full smartphone interface in your browser so you can chat and interact with AI characters you create. Inside the simulated phone you get private chats, group chats, a social feed similar to a moments or timeline feature, voice messages, and simulated money transfer cards, and the AI characters are designed to have their own daily schedules, memory, and ongoing relationships with you over time. The app includes a creation system for building characters, including character cards, a world or lore book for background setting information, presets, and text pattern rules, plus a built in desktop assistant character to help you write this content. On top of chatting, it supports story style gameplay, including a visual novel mode, a feature to browse a character's simulated phone, interview style scenes, a map based adventure mode, a diary, and a sticky note wall. It also has an extension system with an app marketplace where developers can build custom mini apps using an SDK, plus a game hall with built in small games. Additional features include AI image generation, Minimax voice synthesis, optional NetEase Cloud Music integration, and 3D world building through the Tripo service, along with desktop customization like themes, wallpapers, and widgets, and the ability to install it as an app to a phone's home screen. The project does not include any AI model service itself. You must supply your own API key for an OpenAI compatible service, or Anthropic's or Google's official APIs, and other features like image generation or music require their own separately configured API keys. It can be run locally with Node.js or deployed to Netlify or Vercel, and a self hosted mode skips any account or activation code requirement for personal use. Optional cloud features like accounts, an app marketplace, and a game hall need your own Supabase project. The project credits SillyTavern as an inspiration for some of its design concepts and is released under the AGPL-3.0 license.

prompts (copy fr)

prompt 1

Help me set up AI Virtual Phone locally and connect it to my own LLM API key.

prompt 2

Show me how to deploy AI Virtual Phone to Vercel in self hosted mode.

prompt 3

Explain how to set up my own Supabase project for the accounts and app marketplace features.

prompt 4

Walk me through creating a character card and world book for AI Virtual Phone.

Frequently asked questions