Staidium - AI Platform for Multi-Model Chat

Enterprise-grade AI platform with multi-model support, team collaboration, and developer tools

Features • Quick Start • Documentation • Contributing • License

Overview

Staidium is a comprehensive AI platform that enables users to interact with multiple AI models through a unified interface. Built with Next.js 15, TypeScript, and Supabase, it provides a robust foundation for AI-powered applications.

Features

🤖 Multi-Model AI Support

• Multiple Providers: OpenAI, Anthropic, Cohere, Hugging Face
• Model Switching: Seamlessly switch between models mid-conversation
• Custom Models: Support for custom model configurations
• Streaming Responses: Real-time streaming for better UX

💬 Advanced Chat System

• Thread Management: Organize conversations into threads
• Message Voting: Rate AI responses for quality
• Document Generation: Export conversations and generate reports
• Team Collaboration: Share threads with team members

🛠️ Developer Tools

• API Access: RESTful API with comprehensive documentation
• API Key Management: Secure key generation and management
• Testing Playground: Test models and prompts
• Performance Benchmarks: Compare model performance

🎨 Customization

• Theme System: 12 pre-built themes with dark/light modes
• Custom Branding: Personalize the interface
• Responsive Design: Works on desktop and mobile
• PWA Support: Install as a Progressive Web App

🔐 Security & Privacy

• Row-Level Security: Database-level access control
• OAuth Integration: Multiple authentication providers
• API Rate Limiting: Prevent abuse
• Data Encryption: Secure data storage

Tech Stack

• Frontend: Next.js 15.2.4, React 18, TypeScript
• Styling: Tailwind CSS, shadcn/ui
• Database: Supabase (PostgreSQL)
• AI Integration: Vercel AI SDK, multiple provider SDKs
• Authentication: Supabase Auth
• Deployment: Vercel/Railway/Self-hosted

Quick Start

Prerequisites

• Node.js 18.17 or higher
• npm or yarn
• Supabase account (free tier available)
• AI provider API keys (optional for development)

Installation

1. Clone the repository

   git clone https://github.com/yourusername/staidium.git
   cd staidium3

2. Install dependencies

   npm install
   # or
   yarn install

3. Set up environment variables

   cp .env.example .env.local

   Edit .env.local with your configuration (see Environment Setup)

4. Set up the database

   # Using Supabase CLI (recommended)
   supabase start
   supabase db push
   
   # Or use your Supabase cloud project

5. Run the development server

   npm run dev
   # or
   yarn dev

6. Open the application Navigate to http://localhost:3000

Environment Setup

Create a .env.local file with the following variables:

# Supabase
NEXT_PUBLIC_SUPABASE_URL=your_supabase_project_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key

# Optional: AI Providers
OPENAI_API_KEY=your_openai_api_key
ANTHROPIC_API_KEY=your_anthropic_api_key

# Optional: Haive Backend
HAIVE_API_URL=https://api.haive.app
HAIVE_API_KEY=your_haive_api_key

# Application
NEXT_PUBLIC_APP_URL=http://localhost:3000

Documentation

Comprehensive documentation is available in the /docs/claude_docs directory:

• 📚 Getting Started Guide - Set up your development environment
• 🏗️ Architecture Overview - Understand the system design
• 🔌 API Documentation - RESTful API reference
• 🧩 Component Library - UI component documentation
• 💡 Feature Guides - Detailed feature documentation
• 👨‍💻 Development Workflow - Best practices and procedures

Project Structure

staidium3/
├── src/
│   ├── app/              # Next.js App Router pages
│   ├── components/       # React components
│   ├── lib/              # Core business logic
│   ├── hooks/            # Custom React hooks
│   ├── types/            # TypeScript type definitions
│   └── utils/            # Utility functions
├── public/               # Static assets
├── docs/                 # Documentation
│   └── claude_docs/      # Comprehensive developer docs
├── supabase/            # Database migrations and config
└── tests/               # Test files

Scripts

# Development
npm run dev              # Start development server
npm run build            # Build for production
npm run start            # Start production server

# Code Quality
npm run lint             # Run ESLint
npm run lint:fix         # Fix linting issues
npm run type-check       # TypeScript type checking
npm run format           # Format with Prettier

# Testing
npm run test             # Run tests
npm run test:watch       # Run tests in watch mode
npm run test:coverage    # Generate coverage report

# Database
npm run db:generate      # Generate TypeScript types from DB
npm run db:migrate       # Run database migrations
npm run db:seed          # Seed database with sample data

Contributing

We welcome contributions! Please see our Contributing Guide for details on:

• Code of Conduct
• Development process
• Submitting pull requests
• Coding standards
• Testing requirements

Quick Contribution Guide

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Deployment

Vercel (Recommended)

Manual Deployment

1. Build the application:

   npm run build

2. Set production environment variables

3. Start the server:

   npm run start

See Deployment Guide for detailed instructions.

Support

• 📖 Documentation: Check our comprehensive docs
• 💬 Discussions: Join our GitHub Discussions
• 🐛 Issues: Report bugs on GitHub Issues
• 📧 Email: [email protected]

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Built with Next.js
• UI components from shadcn/ui
• Database by Supabase
• AI integration via Vercel AI SDK

---

Made with ❤️ by the Staidium Team