# josStorer/RWKV-Runner

A RWKV management and startup tool, full automation, only 8MB. And provides an interface compatible with the OpenAI API. RWKV is a large language model that is fully open source and available for commercial use.

Repository: https://github.com/josStorer/RWKV-Runner
Canonical: https://ross.abutalabs.com/products/rwkv-runner
Homepage: https://www.rwkv.com
Language: TypeScript
License: MIT
License Family: permissive
Topics: rwkv, api, api-client, chatgpt, llm, tool, wails
Last push: 2026-07-07T03:45:32+00:00

## Health v2 (maintenance only)
Score: 86/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 91, release rhythm 80, longevity 86
- inputs: {"age_days": 1216, "days_push": 57, "days_rel": 57, "gap_med": 44.0, "n_releases_24m": 15}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6462, forks 600 (observed 2026-08-28T04:09:43.632302+00:00)

## What it is
RWKV-Runner is a lightweight desktop application that automates downloading, managing, and running RWKV large language models with a GUI. It exposes an OpenAI-compatible API server so any ChatGPT client can be used as an RWKV client.

## Use cases
- run RWKV language models locally with one click
- serve an OpenAI-compatible API for RWKV models
- manage and download LLM model files
- use ChatGPT clients with RWKV models
- deploy an LLM backend on a server
- chat with local language models offline

## When to choose
- you want to run RWKV models without manual setup
- you need an OpenAI API-compatible local LLM server
- you want a lightweight GUI for local model management
- you prefer fully open-source, commercially usable LLMs

## When to avoid
- you need to run GPT-style transformer models like Llama
- you only want a headless inference library
- you require fine-tuning workflows (use RWKV-PEFT instead)

## Facets
- artifact type: application
- maturity: active
- function: llm-inference, http-server, gui, chatbot
- domain: large-language-models, artificial-intelligence, developer-tools, self-hosted
- platform: windows, cross-platform
- tags: rwkv, openai-api-compatible, model-manager, wails, local-llm, macos, linux, desktop

## Member repositories
- josStorer/RWKV-Runner (main) score 86

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:43.632302+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:44:37.495119+00:00, confidence not recorded.
  - readme: https://github.com/josStorer/RWKV-Runner (fetched 2026-08-28T04:09:43.632302+00:00, sha f718246e2f75)
  - homepage: https://www.rwkv.com (fetched 2026-08-29T08:41:30.424447+00:00, sha 0deceb7fb6f5)
- Data as of 2026-08-30T08:39:29.467469+00:00.
