Skip to content

Latest commit

 

History

History
194 lines (137 loc) · 6.12 KB

README.md

File metadata and controls

194 lines (137 loc) · 6.12 KB

Open-Fiesta

Open-Fiesta

An open-source, multi-model AI chat playground built with Next.js App Router. Switch between providers and models, compare outputs side-by-side, and use optional web search and image attachments.

Features

  • Multiple providers: Gemini, OpenRouter (DeepSeek R1, Llama 3.3, Qwen, Mistral, Moonshot, Reka, Sarvam, etc.)
  • Selectable model catalog: choose up to 5 models to run
  • Web search toggle per message
  • Image attachment support (Gemini)
  • Conversation sharing: Share conversations with shareable links
  • Clean UI: keyboard submit, streaming-friendly API normalization

Tech Stack

  • Next.js 14 (App Router, TypeScript)
  • Tailwind CSS
  • API routes for provider calls
  • Docker containerization support

Quick Start

Option 1: Traditional Development

  1. Install deps
npm i
  1. Configure environment Copy the example environment file:
cp .env.example .env

Then set the environment variables you plan to use. You can also enter keys at runtime in the app's Settings.

# OpenRouter (wide catalog of community models)
OPENROUTER_API_KEY=your_openrouter_key

# Google Gemini (Gemini 2.5 Flash/Pro)
GEMINI_API_KEY=your_gemini_key

# Unstable Inference endpoint (custom provider)
  1. Run dev server
npm run dev
# open http://localhost:3000

Environment Variables

Set only those you need; others can be provided per-request from the UI:

Ollama Support

Open-Fiesta supports local Ollama models. To use Ollama:

  1. Configure Ollama:

    • Ensure Ollama is running and accessible: ollama serve
    • Make sure Ollama is configured to accept external connections by setting: 
      export OLLAMA_HOST=0.0.0.0:11434

  2. Add Ollama Models:

    • Go to the "Custom Models" section in the app (wrench icon)
    • Add Ollama models by entering the model name (e.g., "llama3", "mistral", "gemma")
    • The system will validate that the model exists in your Ollama instance

  3. Docker Networking:

    • If running Open-Fiesta in Docker, use http://host.docker.internal:11434 as the Ollama URL
    • This allows the Docker container to communicate with Ollama running on your host machine

  4. Select and Use:

    • Select your Ollama models in the model picker
    • Start chatting with your locally running models

Docker Support

This project includes comprehensive Docker support for both development and production:

Development

  • Hot reload enabled for instant code changes
  • Volume mounting for live code updates
  • Includes all development dependencies

Production

  • Multi-stage build for optimized image size (~100MB)
  • Proper security practices with non-root user
  • Environment variable configuration support

Available Docker Commands

  • npm run docker:build - Build production Docker image
  • npm run docker:run - Run production container
  • npm run docker:dev - Start development environment with Docker Compose
  • npm run docker:prod - Start production environment with Docker Compose

Project Structure

  • app/ – UI and API routes
    • api/openrouter/route.ts – normalizes responses across OpenRouter models; strips reasoning, cleans up DeepSeek R1 to plain text
    • api/gemini/route.ts, api/gemini-pro/route.ts
    • shared/[encodedData]/ – shared conversation viewer
  • components/ – UI components (chat box, model selector, etc.)
    • shared/ – components for shared conversation display
  • lib/ – model catalog and client helpers
    • sharing/ – conversation sharing utilities
  • Dockerfile – Production container definition
  • Dockerfile.dev – Development container definition
  • docker-compose.yml – Multi-container setup
  • .dockerignore – Files to exclude from Docker builds

Notes on DeepSeek R1

Open-Fiesta post-processes DeepSeek R1 outputs to remove reasoning tags and convert Markdown to plain text for readability while preserving content.

Contributing

We welcome contributions of all kinds: bug fixes, features, docs, and examples.

  • Set up

    • Fork this repo and clone your fork.
    • Start the dev server with npm run dev.

  • Branching

    • Create a feature branch from main: feat/<short-name> or fix/<short-name>.

  • Coding standards

    • TypeScript, Next.js App Router.
    • Run linters and build locally:
      • npm run lint
      • npm run build
    • Keep changes focused and small. Prefer clear names and minimal dependencies.

  • UI/UX

    • Reuse components in components/ where possible.
    • Keep props typed and avoid unnecessary state.

  • APIs & models

    • OpenRouter logic lives in app/api/openrouter/.
    • Gemini logic lives in app/api/gemini/ and app/api/gemini-pro/.
    • If adding models/providers, update lib/models.ts or lib/customModels.ts and ensure the UI reflects new options.

  • Docker changes

    • When modifying dependencies, ensure both Dockerfile and Dockerfile.dev are updated if needed
    • Test both development and production Docker builds

  • Commit & PR

    • Write descriptive commits (imperative mood): fix: …, feat: …, docs: ….
    • Open a PR to main with:
      • What/why, screenshots if UI changes, and testing notes.
      • Checklist confirming npm run lint and npm run build pass.
      • Test both traditional and Docker setups if applicable.
    • Link related issues if any.

  • Issue reporting

Thank you for helping improve Open‑Fiesta!

License

This project is licensed under the MIT License. See LICENSE for details.

Acknowledgements

  • Model access via OpenRouter and Google