josStorer/RWKV-Runner is an AI-powered project on GitHub with 6.5k stars, written primarily in TypeScript. 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.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
This project aims to eliminate the barriers of using large language models by automating everything for you. All you
need is a lightweight executable program of just a few megabytes. Additionally, this project provides an interface
compatible with the OpenAI API, which means that every ChatGPT client is an RWKV client.
English | 简体中文 | 日本語
Install
FAQs | Preview | Download | Simple Deploy Example | Server Deploy Examples | MIDI Hardware Input
Tips
You can deploy backend-python on a server and use this program as a client only. Fill in
your server address in the Settings API URL.
If you are deploying and providing public services, please limit the request size through API gateway to prevent
excessive resource usage caused by submitting overly long prompts. Additionally, please restrict the upper limit of
requests' max_tokens based on your actual
situation: https://github.com/josStorer/RWKV-Runner/blob/master/backend-python/utils/rwkv.py#L567, the default is set
as le=102400, which may result in significant resource consumption for individual responses in extreme cases.
Default configs has enabled custom CUDA kernel acceleration, which is much faster and consumes much less VRAM. If you
encounter possible compatibility issues (output garbled), go to the Configs page and turn
off Use Custom CUDA kernel to Accelerate, or try to upgrade your gpu driver.
If Windows Defender claims this is a virus, you can try
downloading v1.3.7_win.zip
and letting it update automatically to the latest version, or add it to the trusted
list (Windows Security -> Virus & threat protection -> Manage settings -> Exclusions -> Add or remove exclusions -> Add an exclusion -> Folder -> RWKV-Runner).
For different tasks, adjusting API parameters can achieve better results. For example, for translation tasks, you can
try setting Temperature to 1 and Top_P to 0.3.
Features
RWKV model management and one-click startup.
Front-end and back-end separation, if you don't want to use the client, also allows for separately deploying the
front-end service, or the back-end inference service, or the back-end inference service with a WebUI.
Simple Deploy Example | Server Deploy Examples
Compatible with the OpenAI API, making every ChatGPT client an RWKV client. After starting the model,
open http://127.0.0.1:8000/docs to view more details.
Automatic dependency installation, requiring only a lightweight executable program.
Pre-set multi-level VRAM configs, works well on almost all computers. In Configs page, switch Strategy to WebGPU, it
can also run on AMD, Intel, and other graphics cards.
User-friendly chat, completion, and composition interaction interface included. Also supports chat presets, attachment
uploads, MIDI hardware input, and track editing.
Preview | MIDI Hardware Input
Built-in WebUI option, one-click start of Web service, sharing your hardware resources.
Easy-to-understand and operate parameter configuration, along with various operation guidance prompts.
Built-in model conversion tool.
Built-in download management and remote model inspection.
Built-in one-click LoRA Finetune. (Windows Only)
Can also be used as an OpenAI ChatGPT, GPT-Playground, Ollama, llmman and more
clients. (Fill in the API URL and API Key in Settings page)
Multilingual localization.
Theme switching.
Automatic updates.
Simple Deploy Example
git clone https://github.com/josStorer/RWKV-Runner
# Then
cd RWKV-Runner
python ./backend-python/main.py #The backend inference service has been started, request /switch-model API to load the model, refer to the API documentation: http://127.0.0.1:8000/docs
# Or
cd RWKV-Runner/frontend
npm ci
npm run build #Compile the frontend
cd ..
python ./backend-python/webui_server.py #Start the frontend service separately
# Or
python ./backend-python/main.py --webui #Start the frontend and backend service at the same time
# Help Info
python ./backend-python/main.py -h
Note: v1.4.0 has improved the quality of embeddings API. The generated results are not compatible
with previous versions. If you are using embeddings API to generate knowledge bases or similar, please regenerate.
If you are using langchain, just use OpenAIEmbeddings(openai_api_base="http://127.0.0.1:8000", openai_api_key="sk-")
import numpy as np
import requests
def cosine_similarity(a, b):
return np.dot(a, b) / (np.linalg.norm(a) * np.linalg.norm(b))
values = [
"I am a girl",
"我是个女孩",
"私は女の子です",
"广东人爱吃福建人",
"我是个人类",
"I am a human",
"that dog is so cute",
"私はねこむすめです、にゃん♪",
"宇宙级特大事件!号外号外!"
]
embeddings = []
for v in values:
r = requests.post("http://127.0.0.1:8000/embeddings", json={"input": v})
embedding = r.json()["data"][0]["embedding"]
embeddings.append(embedding)
compared_embedding = embeddings[0]
embeddings_cos_sim = [cosine_similarity(compared_embedding, e) for e in embeddings]
for i in np.argsort(embeddings_cos_sim)[::-1]:
print(f"{embeddings_cos_sim[i]:.10f} - {values[i]}")
MIDI Input
Tip: You can download https://github.com/josStorer/sgm_plus and unzip it to the program's assets/sound-font directory
to use it as an offline sound source. Please note that if you are compiling the program from source code, do not place
it in the source code directory.
If you don't have a MIDI keyboard, you can use virtual MIDI input software like Virtual Midi Controller 3 LE, along
with loopMIDI, to use a regular
computer keyboard as MIDI input.
USB MIDI Connection
USB MIDI devices are plug-and-play, and you can select your input device in the Composition page
Mac MIDI Bluetooth Connection
For Mac users who want to use Bluetooth input,
please install Bluetooth MIDI Connect, then click
the tray icon to connect after launching,
afterwards, you can select your input device in the Composition page.
Windows MIDI Bluetooth Connection
Windows seems to have implemented Bluetooth MIDI support only for UWP (Universal Windows Platform) apps. Therefore, it
requires multiple steps to establish a connection. We need to create a local virtual MIDI device and then launch a UWP
application. Through this UWP application, we will redirect Bluetooth MIDI input to the virtual MIDI device, and then
this software will listen to the input from the virtual MIDI device.
So, first, you need to
download loopMIDI
to create a virtual MIDI device. Click the plus sign in the bottom left corner to create the device.
Next, you need to download Bluetooth LE Explorer to discover and
connect to Bluetooth MIDI devices. Click "Start" to search for devices, and then click "Pair" to bind the MIDI device.
Finally, you need to install MIDIberry,
This UWP application can redirect Bluetooth MIDI input to the virtual MIDI device. After launching it, double-click
your actual Bluetooth MIDI device name in the input field, and in the output field, double-click the virtual MIDI
device name we created earlier.
Now, you can select the virtual MIDI device as the input in the Composition page. Bluetooth LE Explorer no longer
needs to run, and you can also close the loopMIDI window, it will run automatically in the background. Just keep
MIDIberry open.
Tip: You can download https://github.com/josStorer/sgm_plus and unzip it to the program's assets/sound-font directory
to use it as an offline sound source. Please note that if you are compiling the program from source code, do not place
it in the source code directory.
How active is development on josStorer/RWKV-Runner?
The most recent commit recorded on josStorer/RWKV-Runner was 4 months ago, based on the GitHub push timestamp. The repository has 594 forks — one of the better signals of community interest.
How many stars does josStorer/RWKV-Runner have?
josStorer/RWKV-Runner has 6.5k GitHub stars — refresh the page for the live number, or check github.com/josStorer/RWKV-Runner. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is josStorer/RWKV-Runner open source?
Yes — josStorer/RWKV-Runner ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/josStorer/RWKV-Runner.
What else is in the AI Tools space?
josStorer/RWKV-Runner is tracked by TopGit under the AI Tools category, alongside 7 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What is josStorer/RWKV-Runner?
josStorer/RWKV-Runner (josStorer/RWKV-Runner) is a TypeScript project on GitHub. From the project's own README: 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.
What language is josStorer/RWKV-Runner written in?
josStorer/RWKV-Runner is written primarily in TypeScript. GitHub's language field is based on the largest share of bytes in the default branch.
What license does josStorer/RWKV-Runner use?
josStorer/RWKV-Runner is released under the MIT license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where do I read more about josStorer/RWKV-Runner?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/josStorer/RWKV-Runner is the definitive source.
Read full README in the tab above.
Still deciding about RWKV-Runner?
One click hands the question to an AI along with this page — see what it says about RWKV-Runner.