🤖 Open Character AI

An interactive, high-fidelity AI companion portal where users explore preset personas, forge custom AI characters, and fine-tune LLM parameters per chat. Built with Next.js (App Router), this application is a self-contained SaaS boilerplate featuring user authentication, credit billing, and a beautiful chat interface powered by the MuAPI engine.

🎨 Explore 50+ more open-source AI apps →

https://github.com/user-attachments/assets/b6e252c0-6e06-4333-bc53-5d6856811868

🌐 Project Details

GitHub Repository: github.com/Anil-matcha/open-character-ai

Live Demo: open-character-ai.vercel.app

Sign in with Google to explore preset characters, customize your own companion, tune generation parameters in real-time, and manage credit tokens.

---

Open Character AI is a production-ready, highly-optimized AI web application. Out of the box, it seamlessly manages User Authentication, Credits & Billing, Chat Persistence, and real-time LLM interaction utilizing a sleek Next.js (App Router) architecture. It empowers creators, developers, and brands to host their own custom companion portals.

Why use Open Character AI?

• Production-Ready SaaS — Complete with Google OAuth and Stripe Checkout workflows built-in.
• Glassmorphic Chat UI — A premium dark mode user interface featuring message bubbles, typing indicators, custom avatars, and a slide-out parameter console.
• Interactive Character Builder — Create public or private personas with custom system prompts, greets, and avatars.
• Dynamic LLM Tuning — Slide-out drawer configuration allows adjusting Temperature, Max Tokens, and System Prompt values per chat thread.
• Persistent Chat History — All conversations, customized parameters, and creations are securely saved to a PostgreSQL database via Prisma ORM.

---

✨ Core Features

💬 Interactive Chat Studio (/[character_name]/[id])

• Fully-featured messaging workspace with typing simulation.
• LLM Tuning Panel — Slider controls to dynamically tweak Temperature, Max Tokens, and edit/override System Prompt instructions per session.
• Message history persisted in database with real-time UI synchronization.

🎭 Dashboard & Character Builder (/)

• Choose from featured, anime, helper, or gaming categories.
• Create new companion personas via a visual builder modal specifying Name, Description, Greeting Message, Personality, System Instructions, Avatar, and Visibility (Public vs. Private).

💳 Stripe Credit Billing (/pricing)

• Select credit pack plans for premium LLM interactions.
• Pay-as-you-go credit balances, instantly updated via Stripe checkout webhooks.

🔐 Google Authentication & Persistence

• NextAuth Google provider mapped to the shared PostgreSQL schema via Prisma.
• Live credit tracker with real-time balance checks before message telemetry.

---

⚠️ Database Safety Warning (Shared Pool)

This application shares a single PostgreSQL database instance on Supabase with other applications in this workspace. Running npx prisma db push on a clean, empty schema will drop tables belonging to other applications. Always follow the Pull-Declare-Push-Cleanup sequence:

1. Introspect First: Run npx prisma db pull to fetch all existing tables into your local schema.prisma.
2. Declare Your Models: Declare your application-specific tables (Character, Chat, Message, Creation, UserImage) and update their relations inside the User model.
3. Push Changes: Run npx prisma db push to safely update the database schema without touching or dropping existing tables of other apps.
4. Clean Up Schema: Remove other apps' models from schema.prisma to keep the code clean and compile compact types (retain only Account, Session, User, VerificationToken, your custom tables, and the User relations).
5. Generate Client: Run npx prisma generate to rebuild the type-safe Prisma client for your selected models.

---

⚡ Deployment: Vercel & Production

This architecture is engineered explicitly for Vercel serverless environments.

🔑 Required Environment Variables

To successfully deploy and run, populate the following environment variables in your Vercel project settings:

Service	Variable	Description & Source
Database	DATABASE_URL	PostgreSQL connection string (Supabase or Neon)
	DIRECT_URL	Direct DB connection for Prisma migrations and schema introspections
NextAuth / Google	NEXTAUTH_SECRET	Secure random string generated via openssl rand -base64 32
	NEXTAUTH_URL	Your production domain (e.g. https://open-character-ai.vercel.app)
	GOOGLE_CLIENT_ID	Get from Google Cloud Console
	GOOGLE_CLIENT_SECRET	Get from Google Cloud Console
Stripe Billing	STRIPE_SECRET_KEY	Get from Stripe Dashboard
	NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY	Get from Stripe Dashboard
	STRIPE_WEBHOOK_SECRET	Webhook secret for resolving credit purchases
AI Generator / LLM	MU_API_KEY	API key from muapi.ai (for model routing/API calls)
	WEBHOOK_URL	Webhook URL endpoint for async events
UI Configuration	NEXT_PUBLIC_THEME	Dynamic UI color theme accent: Choose from indigo, emerald, rose, amber, violet

🚀 Launching on Vercel: Step-by-Step

1. Database Provisioning: Create a new Postgres database (via Supabase or Neon) and retrieve connection URLs.
2. Project Creation: Import your GitHub repository into the Vercel dashboard.
3. Configure Environment Variables: Add all variables listed in the settings tab.
4. Deploy: Build with Vercel. Next.js page generation will run Prisma client generation automatically via our script config.
5. Database Push: Synchronize database models before launching.
6. Webhooks Setup: Configure Stripe checkout webhook to point to /api/stripe/webhook.

---

🛠️ Local Development

Prerequisites

• Node.js (v18 or higher)
• A local/cloud PostgreSQL instance.

Setup

# 1. Clone the repository
git clone https://github.com/Anil-matcha/open-character-ai
cd open-character-ai

# 2. Install dependencies
npm install

# 3. Setup Environment
cp .env.example .env
# Open .env and insert your specific keys.

# 4. Initialize Database Schema
# Note: Because the database is shared, see the Safety Warning above!
npx prisma generate
npx prisma db push

# 5. Start the Development Server
npm run dev

The console should now be active on http://localhost:3000.

---

🏗️ Technical Architecture

character-ai/
├── prisma/
│   └── schema.prisma           # Postgres schema (User, Account, Session, Character, Chat, Message, Creation, UserImage)
├── src/
│   ├── app/                    # Next.js App Router
│   │   ├── page.js             # Dashboard / Character selection & custom character builder modal
│   │   ├── layout.js           # Root layout importing fonts, background styles, and Providers
│   │   ├── globals.css         # Global cyber/dark styling utilities and variables
│   │   ├── pricing/            # Credit purchase plans & checkout triggers (/pricing)
│   │   │   └── page.js
│   │   ├── [character_name]/[id]/
│   │   │   └── page.js         # Interactive chat interface with parameter controls and message list
│   │   └── api/
│   │       ├── auth/           # NextAuth Google OAuth handler
│   │       ├── characters/     # GET / POST characters (custom builder handler)
│   │       ├── chats/          # GET / POST chats, messages list, parameters tuning
│   │       │   ├── [id]/
│   │       │   │   └── messages/   # GET / POST messages for a specific chat
│   │       │   └── route.js
│   │       ├── images/         # Upload/CDN helpers for avatars
│   │       ├── stripe/         # Checkout session creation & payment webhooks
│   │       └── upload/         # File uploading helper endpoint
│   ├── components/
│   │   └── Providers.jsx       # NextAuth SessionProvider wrapper
│   └── lib/
│       ├── auth.js             # NextAuth configuration with Google OAuth and Prisma adapter
│       └── prisma.js           # Global PrismaClient singleton with PG adapter
└── next.config.mjs             # Next.js configuration

---

🔗 Related Projects

• Open-Pomelli — Open-source Pomelli alternative — self-hosted AI assistant platform.
• Open-Poe-AI — Open-source Poe alternative — chat with multiple LLMs from one interface.

---

📄 License

MIT Licensed.