RedPlanetHQ/core

Add OpenRouter support as LLM provider

Open

#130 opened on Oct 28, 2025

View on GitHub
 (1 comment) (0 reactions) (1 assignee)TypeScript (184 forks)auto 404
enhancementgood first issue

Repository metrics

Stars
 (1,930 stars)
PR merge metrics
 (PR metrics pending)

Description

Description

Add support for OpenRouter as an LLM provider to enable access to multiple models through a single API.

Files to Look At

Provider Implementation

  • apps/webapp/app/lib/batch/providers/anthropic.ts - Reference for provider structure
  • apps/webapp/app/lib/batch/providers/openai.ts - Another provider example

Configuration

  • docs/providers/ - Provider documentation directory
  • docs/self-hosting/environment-variables.mdx - Where to add new env vars

Implementation Tasks

  • Create apps/webapp/app/lib/batch/providers/openrouter.ts
  • Add OpenRouter API integration
  • Add environment variable configuration (OPENROUTER_API_KEY)
  • Create documentation in docs/providers/openrouter.mdx
  • Update environment variables documentation
  • Add model selection UI if needed

Technical Notes

  1. OpenRouter uses an OpenAI-compatible API, so you can likely extend/adapt the OpenAI provider
  2. API endpoint: https://openrouter.ai/api/v1
  3. Requires HTTP-Referer and X-Title headers for attribution
  4. Supports streaming responses

Resources

Labels

good first issue, enhancement

Contributor guide

Research direction
Look at the existing OpenAI provider (openai.ts) and adapt it for OpenRouter, adjusting the base URL to https://openrouter.ai/api/v1 and adding required HTTP Referer and X Title headers. Also add the OPENROUTER API KEY environment variable and update documentation.
Tech stack
typescriptnodejs
Domain
backendapi
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
GitTypeScript
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
80