MultifariousAI 🎉

Free & Open-Source Multi-AI Platform - Chat with 100+ AI models including cloud APIs and local Ollama models, all in one place!

✨ Features

🌐 Cloud AI Models

100+ Free AI Models - Use OpenRouter's free tier
Premium Models - Access Claude 3.5, GPT-4o, and more with your own keys
Multiple Providers - OpenRouter, Google Gemini, Mistral, and more
Real-time Streaming - Watch responses generate character by character

💻 Local AI Models (Ollama)

Ollama Integration - Run models locally on your machine
Privacy First - No data leaves your device
Cost-Free - Use free local models like Llama, Mistral, Qwen
Auto-Discovery - Automatically import all your Ollama models
Provider-agnostic Architecture - Use local models with the same interface as cloud models

♿ Accessibility & UX

WCAG 2.1 Compliant - Built with accessibility best practices
Keyboard Navigation - Fully navigable via keyboard
Skip Link - Bypass navigation to reach main content quickly
ARIA Standards - Proper roles and labels for screen readers
Reduced Motion - Respects system-level motion preferences
High Contrast Support - Optimized for high contrast modes

🔥 Core Features

Chat Persistence - Save conversations to PostgreSQL database
Multi-Model Chat - Compare up to 5 models side-by-side
Chat History - Persistent storage with database
Dark Mode - Beautiful dark theme support
File Upload - Support for images, PDFs, and DOCX files
Custom Models - Add your own OpenRouter or Ollama models
Responsive Design - Works perfectly on desktop and mobile
Animated Onboarding - 5-step interactive walkthrough for new users
Loading Skeletons - Smooth perceived performance with animated loading states

🎨 Modern UI

Clean, intuitive interface built with Tailwind CSS
Shadcn/ui components for consistent design
Real-time streaming responses
Keyboard Shortcuts Dialog - Press Ctrl+/ to discover all shortcuts
Global Shortcuts - Ctrl+K (Model Selector), Ctrl+N (New Chat)

🚀 Quick Start (For Everyone!)

🖥️ Windows Users (Easiest!)

Download Node.js from nodejs.org and install it
Download this project: Click the green "Code" button → "Download ZIP" → Extract it
Double-click START.bat in the extracted folder
That's it! The app opens in your browser automatically

🍎 Mac/Linux Users

Install Node.js:
- Mac: brew install node or download from nodejs.org
- Linux: sudo apt install nodejs npm
Download this project and extract it
Open Terminal in the project folder and run:
```
chmod +x START.sh && ./START.sh
```
Done! Opens at http://localhost:3000

👨‍💻 For Developers

Prerequisites

Node.js 20+
npm, yarn, or pnpm
PostgreSQL database (optional - for OAuth, chat sharing)

Installation

Clone the repository

git clone https://github.com/workbydivyanshu/multifariousAI.git
cd multifariousAI

Install dependencies

npm install

Run the development server

npm run dev

Open http://localhost:3000

That's it! The app works fully locally without any database. Chat history is stored in browser localStorage.

Advanced Setup (Optional)

For full features like OAuth login and chat sharing, set up environment variables:

cp .env.example .env.local

Database Setup:

Install PostgreSQL locally or use a cloud provider (Supabase, Neon, etc.)
Create a database named multifariousai
Update DATABASE_URL in .env.local

OAuth Setup:

GitHub OAuth: Go to GitHub Settings > Developer settings > OAuth Apps
Google OAuth: Go to Google Cloud Console > APIs & Credentials
Add your OAuth client IDs and secrets to .env.local

Run database migrations:

npm run db:setup


7. **Open [http://localhost:3000](http://localhost:3000)**

That's it! Sign up/login and start chatting!

### Option 2: Docker Desktop

**Note**: Docker Desktop needs to be running for Docker commands to work.

#### Build and Run with Docker Compose

1. **Ensure Docker Desktop is running**
2. **Build image** (Optional - docker-compose handles this)
```bash
docker-compose build

Run container

docker-compose up --build

Access the app

http://localhost:3000

Troubleshooting Docker Issues

If Docker daemon is not responding:

Restart Docker Desktop - Stop and start Docker Desktop
Check Docker Engine - Run docker info in terminal
Clear cache - Run docker system prune -f to clear build cache
Try direct Docker build:

docker build -t multifariousai .

Alternative: Use WSL2 or Git Bash

If you have WSL2 installed:

# In WSL2 terminal
cd multifariousAI
docker-compose up --build

Option 3: Alternative: Vercel (Recommended for Production)

Deploy to Vercel

Push to GitHub (already done!)
Go to vercel.com
Import project - Connect GitHub repository
Add environment variables (if needed)
Deploy

Option 4: Local Development (No Docker)

Without Docker

Install dependencies

npm install

Build for production

npm run build

Run production server

npm run start

🎯 Getting API Keys (Optional)

Free Models - Key Required!

The following models work with API key:

✅ Llama 3.3 70B (Free)
✅ Qwen 2.5 72B (Free)
✅ Gemma 3 27B (Free)
✅ GLM 4.5 Air (Free)
✅ And 20+ more free models!

Premium Models (Optional)

If you want to access premium models, add your API keys in Settings:

OpenRouter (Recommended)

Visit openrouter.ai
Sign up and get your API key
Paste in Settings to access:
- Claude 3.5 Sonnet
- GPT-4o
- GPT-4o Mini
- And 100+ more models!

Google Gemini

Visit makersuite.google.com
Create a project and get your API key
Paste in Settings to access Gemini models

Mistral

Visit mistral.ai
Get your API key
Access Codestral, Pixtral, and Mistral's latest models

📁 Project Structure

multifariousAI/
├── app/                          # Next.js App Router
│   ├── api/                     # API endpoints
│   │   ├── chat/               # Generic chat endpoint
│   │   ├── openrouter/         # OpenRouter API
│   │   ├── gemini/             # Gemini API
│   │   └── ollama/             # Ollama API
│   ├── globals.css              # Global styles
│   ├── layout.tsx               # Root layout
│   └── page.tsx                # Home page
├── components/                    # React components
│   ├── auth/                   # Authentication components
│   ├── chat/                   # Chat interface
│   ├── settings/               # Settings management
│   └── ui/                     # Reusable UI components
├── lib/                         # Utilities
│   ├── models.ts               # AI model catalog
│   ├── useModels.ts           # Model management hook
│   └── utils.ts               # Helper functions
├── stores/                      # State management
│   └── chat-store.ts          # Zustand store
└── types/                       # TypeScript definitions
    └── index.ts                # Shared types

🛠️ Development

Available Scripts

npm run dev          # Start development server
npm run build        # Build for production
npm run start        # Start production server
npm run lint         # Run ESLint
npm run typecheck    # TypeScript type checking

Docker Support

docker-compose up --build

🌟 Available Free Models

Text Models

Model	Context	Provider
DeepSeek R1	64K	OpenRouter
Llama 3.3 70B	128K	OpenRouter
Qwen 2.5 72B	32K	OpenRouter
Mistral Small 24B	32K	OpenRouter
Gemma 3 27B	128K	OpenRouter
GLM 4.5 Air	128K	OpenRouter
Hunyuan A13B	32K	OpenRouter

Image Models

Model	Provider
Gemini 2.5 Flash Image	OpenRouter

Coding Models

Model	Provider
DeepCoder 14B	OpenRouter

🚧 Roadmap

📄 License

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

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details.

🙏 Acknowledgments

Inspiration:
- Open Fiesta by lokeswaran-aj
- Open-Fiesta by NiladriHazra
Models: OpenRouter, Google Gemini, Ollama, Mistral AI
UI Components: shadcn/ui, Radix UI
AI SDK: Vercel AI SDK

📞 Support

📧 Email: support@multifariousai.com (Coming soon)
🐛 Issues: GitHub Issues
💬 Discussions: GitHub Discussions

Made with ❤️ by workbydivyanshu

⭐ If you find this project helpful, please star it on GitHub!

Name		Name	Last commit message	Last commit date
actions		actions
app		app
components		components
db		db
lib		lib
stores		stores
types		types
.dockerignore		.dockerignore
.env.example		.env.example
.eslintrc.json		.eslintrc.json
.gitattributes		.gitattributes
.gitignore		.gitignore
API_DOCS.md		API_DOCS.md
AUTHENTICATION_IMPLEMENTATION.md		AUTHENTICATION_IMPLEMENTATION.md
AUTH_BUTTON_FIX.md		AUTH_BUTTON_FIX.md
AUTH_SETUP.md		AUTH_SETUP.md
CONTRIBUTING.md		CONTRIBUTING.md
DEPLOYMENT_CHECKLIST.md		DEPLOYMENT_CHECKLIST.md
DEVELOPMENT.md		DEVELOPMENT.md
DOCS_INDEX.md		DOCS_INDEX.md
Dockerfile		Dockerfile
GETTING_STARTED.md		GETTING_STARTED.md
IMPLEMENTATION.md		IMPLEMENTATION.md
IMPROVEMENTS.md		IMPROVEMENTS.md
LICENSE		LICENSE
PROJECT_STATUS.md		PROJECT_STATUS.md
QUICKSTART.md		QUICKSTART.md
README.md		README.md
START.bat		START.bat
START.sh		START.sh
SUMMARY.md		SUMMARY.md
docker-compose.yml		docker-compose.yml
drizzle.config.ts		drizzle.config.ts
next.config.js		next.config.js
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
setup-db.js		setup-db.js
start-docker.bat		start-docker.bat
start-docker.sh		start-docker.sh
tailwind.config.js		tailwind.config.js
test-api.ps1		test-api.ps1
tsconfig.json		tsconfig.json

Latest commit

History

Folders and files

Repository files navigation