README.md

---
title: OpenRouter Multi-Model Chat
emoji: 🤖
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.33.0
app_file: app.py
pinned: false
license: mit
---

# 🌟 OpenRouter Multi-Model Chat

<div align="center">
  <img src="https://img.shields.io/badge/Gradio-4.19.0-blue" alt="Gradio">
  <img src="https://img.shields.io/badge/Python-3.8+-green" alt="Python">
  <img src="https://img.shields.io/badge/License-MIT-yellow" alt="License">
</div>

## 🎯 Overview

A powerful multi-model chat interface that connects to OpenRouter API, giving you access to:
- **GPT-4** (OpenAI)
- **Claude 3** Opus, Sonnet, Haiku (Anthropic)
- **Gemini Pro** (Google)
- **Llama 3** 70B (Meta)
- **Mixtral 8x7B** (Mistral)
- And 10+ more models!

## 🚀 Quick Start

### 1. Get API Key
- Sign up at [OpenRouter.ai](https://openrouter.ai)
- Go to [Keys](https://openrouter.ai/keys)
- Create new key

### 2. Set API Key in Space
- Go to `Settings` → `Variables and secrets`
- Add new secret:
  - Name: `OPENROUTER_API_KEY`
  - Value: `sk-or-v1-xxxxx`

### 3. Start Chatting!
- Select your preferred model
- Type your message
- Enjoy AI responses!

## 💡 Features

### 🤖 Multi-Model Support
Switch between different AI models with a single dropdown:
- **OpenAI**: GPT-4, GPT-3.5
- **Anthropic**: Claude 3 series
- **Google**: Gemini, PaLM
- **Open Source**: Llama, Mistral, Yi

### ⚙️ Advanced Controls
- **Temperature**: Control creativity (0 = focused, 2 = creative)
- **Max Tokens**: Limit response length
- **System Prompt**: Set custom instructions
- **Streaming**: Real-time response generation

### 🎨 Beautiful UI
- Clean, modern interface
- Mobile responsive
- Dark/Light theme support
- Conversation history

## 📖 Usage Examples

### Basic Chat