GitHub - fdietze/tomatic: Openrouter based AI Chat Interface.

Tomatic

Goals

• Frontend-only (statically hosted)
• All AI models via Openrouter
• UI Very close to the LLM API interface. No hidden system prompts.
• Space efficient UI, high information density

Getting Started

You can set up your development environment in two ways. We recommend using Nix for a fully reproducible setup, but a standard Node.js environment works perfectly well.

Recommended Setup (with Nix)

This approach uses a Nix flake to create a consistent development environment. It automatically provides the correct versions of Node.js, pnpm, and other system-level dependencies like browser drivers for tests.

Prerequisites:

• Nix with flakes enabled
• (Optional) direnv for automatic shell activation.

Steps:

1. Enter the development shell. If you have direnv installed, cd into the project directory and run direnv allow. Otherwise, activate it manually:

   The shell hook automatically runs pnpm install on entry.

2. Run the development server.

   The app will be running at http://localhost:5173.

Alternative Setup (with pnpm)

This is a standard setup for a Vite React project. You will need to manage your own Node.js installation.

Prerequisites:

• Node.js (version 24 is recommended, see flake.nix)
• pnpm

Steps:

1. Install project dependencies.

2. Install Playwright browsers. Our end-to-end tests use Playwright, which requires separate browser binaries.

   pnpm exec playwright install

3. Run the development server.

   The app will be running at http://localhost:5173.