AI Virtual Phone is a Next.js-based browser simulation of a mobile phone with AI roleplay, chat, and content creation features. It supports self-hosted mode and multiple optional cloud features via environment variables.
What it is
AI Virtual Phone is a Next.js-based AI-powered virtual phone that simulates a complete mobile experience in the browser. It enables simulated chat with AI roles, social features, and a content creation system.
How it works
The project provides a web app with features for private/group chats,朋友圈 interactions, voice messages, and transfers. It includes a build/deploy workflow for Next.js, with a self-hosted mode toggle via NEXT_PUBLIC_SELF_HOSTED_MODE and optional cloud features configured through a set of environment variables. All LLM calls rely on user-provided API keys; the project does not host models itself.
Getting started
git clone -b main <repo-url>
cd <repo-dir>
npm install
cp .env.example .env.local
npm run dev
Open http://localhost:3001. The default environment variable NEXT_PUBLIC_SELF_HOSTED_MODE is true in .env.example, enabling single-machine login.
To configure LLM APIs, go to Settings → API Settings and provide Base URL and API Key for OpenAI-compatible interfaces, Anthropic, or Google Gemini.
## Recent releases
RELEASES (latest 0):
- none
## Traction
Stars: 211 as reported in the repository metadata.
## Behind the repo
Not applicable since no linked startup/company is provided in the FACTS.
## Caveats
License: AGPL-3.0. The project uses AGPL-3.0-only. Node.js 20+ is required (Next.js 15 requires ≥ 18.18). The README includes multiple environment variables for cloud features (e.g., SUPABASE_URL, ACCOUNT_GATE_SECRET, NEXT_PUBLIC_IMAGE_GEN_PROXY_URL)."} }}}}**