Skip to content

sgzsh269/multiplayer-ai

Repository files navigation

Multiplayer AI

This is an AI-powered group chat app that allows users to form chatrooms and collaboratively interact with AI assistants in real-time. The app's goal is to facilitate collaborative learning, brainstorming, research, and decision-making through a conversational interface.

Tech Stack

Project Structure

Project is a monorepo with the following key directories:

  • /packages/webapp - Frontend and Backend
  • /packages/party - PartyKit multiplayer server
  • /docker - Docker compose files for postgres db and other services
  • /ai-ref - Docs for AI coding agents
    • /external-docs - External API/SDK docs
    • /project-docs - Project spec and task planning docs
  • /.cursor - Cursor rules

Quick Start

Prerequisites

  • Bun Package manager
  • PostgreSQL database
  • Clerk account for authentication
  • OpenAI API key for AI features

Installation

  1. Clone the repository

    git clone <repository-url>
    cd multiplayer-ai
  2. Install dependencies

    bun install
  3. Set up environment variables

  • In /packages/webapp, copy .env.example to .env and fill in the values.
  • In /packages/party, copy .env.example to .env and fill in the values.
  1. Set up the database

    bun run db:migrate
  2. Start development servers

    bun run dev
  3. Access the application

Roadmap

  • File and image queries
  • Tool calling and MCP
  • Multiple AI assistants in a chatroom
  • Mobile-friendly UI/UX

Contributing

Contributions are welcome! Please feel free to open an issue or submit a pull request.

License

This project is under the MIT License

Credits

Vibe-coded with Cursor, Claude, Gemini and O3

About

AI-powered group chat

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published