explaingit

xiaolongbao0709/ai-virtual-phone

Analysis updated 2026-05-18

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

TLDR

A browser based simulated smartphone where you chat, roleplay, and build stories with your own AI characters using your own API key.

Mindmap

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

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

USE CASE 4

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

What is it built with?

TypeScriptNext.jsSupabase

How does it compare?

xiaolongbao0709/ai-virtual-phonerazr001/align-devni5arga/deanonymizer
Stars258257255
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencegeneraldeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 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.

Copy-paste prompts

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

What is ai-virtual-phone?

A browser based simulated smartphone where you chat, roleplay, and build stories with your own AI characters using your own API key.

What language is ai-virtual-phone written in?

Mainly TypeScript. The stack also includes TypeScript, Next.js, Supabase.

What license does ai-virtual-phone use?

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.

How hard is ai-virtual-phone to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ai-virtual-phone for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

Alternatives & similar repos