Modelpublic

shoumenchougou/RWKV7-G1j-2.9B-GGUF

sourceHugging Faceapache-2.0updated 25d agoView on Hugging Face

0likes375downloads

Model Card

<div align="center"> <a href="https://www.rwkv.com/"> <img src="assets/rwkv-logo.webp" width="140" alt="RWKV logo" /> </a> <h1>RWKV7-G1j-2.9B-GGUF</h1> <p><strong>RWKV-7 “Goose” for local inference with Ollama and llama.cpp</strong></p> </div>

This repository provides the RWKV-7 G1j 2.9B base model in GGUF format for local text generation. Start with Q4_K_M, the formal Ollama default for this model size, or choose another file to balance storage, runtime memory, and weight precision.

[!IMPORTANT] This is a base language model, not a safety-aligned instruction-tuned assistant. The prompt formats below provide a conversational interface, but the model may not follow instructions consistently.

About RWKV-7

RWKV-7, also called Goose, is an attention-free recurrent language model. It keeps a constant-size recurrent state instead of an attention KV cache that grows with the preceding sequence. This gives RWKV constant recurrent-state size and constant inference work per generated token, while training remains parallelizable.

The fixed-state property describes the architecture's sequence state. Total memory use still depends on the selected weights, runtime, context configuration, batch size, and hardware backend.

G1j identifies this checkpoint revision. The original checkpoint is available from `BlinkDL/rwkv7-g1`. That immutable source file is 5,896,273,469 bytes with SHA-256 966f3420f833532aae3fb1fd6326533b08d43d23b7b03eaa2f0694a30b64a239.

Choose a file

File	Size	When to choose it
`rwkv7-g1j-2.9b-Q4_K_M.gguf`	`1.79 GiB`	Recommended starting point and the formal Ollama default for this model size.
`rwkv7-g1j-2.9b-Q5_K_M.gguf`	`2.08 GiB`	A middle option between Q4 and Q6.
`rwkv7-g1j-2.9b-Q6_K.gguf`	`2.39 GiB`	A larger quantized option when weight precision matters more than size.
`rwkv7-g1j-2.9b-Q8_0.gguf`	`3.03 GiB`	Largest quantized option in this repository.
`rwkv7-g1j-2.9b-20260831-ctx16384-FP16.gguf`	`5.53 GiB`	Mostly-F16 weights; use when model size is less important.

Smaller quantizations generally reduce storage and runtime memory at the cost of some output quality. File size is not a guarantee of total RAM or VRAM use.

File integrity

File	Bytes	SHA-256
`rwkv7-g1j-2.9b-Q4_K_M.gguf`	`1,919,047,616`	`68c3a49dfc8a6dc34032d7c89adf64542ec9c81229a1333591163717bc3ab7b5`
`rwkv7-g1j-2.9b-Q5_K_M.gguf`	`2,233,620,416`	`6b7a4e354a49c0c3560af7f4ecd9721d845fc03d8d8cef25d7e4901a85568ae0`
`rwkv7-g1j-2.9b-Q6_K.gguf`	`2,567,854,016`	`38bc1bc00beb5ce77c9cd7e7b786aa14303b7530aa3132c1667c57d8aece5426`
`rwkv7-g1j-2.9b-Q8_0.gguf`	`3,258,603,456`	`3004002e250af500592a2e7814cb0e0ab54dafa22a556853540ef36923709577`
`rwkv7-g1j-2.9b-20260831-ctx16384-FP16.gguf`	`5,932,472,256`	`6da9ec2e706800a8c935cba6ec600ecb69ea98ef416f7a7ef755886c2ca14a0c`

Verify a downloaded file with sha256sum <filename> on Linux or Get-FileHash <filename> -Algorithm SHA256 in PowerShell.

Run with Ollama

Install Ollama 0.33.2 or later with RWKV-7 support. The formal 2.9B setup uses the Q4_K_M file and the included Modelfile.ollama.

1. Download the model

With the Hugging Face `hf` CLI:

shell

hf download shoumenchougou/RWKV7-G1j-2.9B-GGUF rwkv7-g1j-2.9b-Q4_K_M.gguf Modelfile.ollama --local-dir rwkv7-g1j-2.9b
cd rwkv7-g1j-2.9b

You can instead download both files from the repository's file browser and place them in the same directory.

2. Create and run the Ollama model

shell

ollama create rwkv7-g1j:2.9b -f Modelfile.ollama
ollama run rwkv7-g1j:2.9b

The setup is complete when ollama create reports success and ollama run returns generated text. This release passed Q4KM import, embedded-template rendering in thinking and non-thinking modes, and non-empty generation with a 16,384-token context setting.

The included Modelfile selects Q4KM, declares the minimum Ollama version, records the license, and sets the release context and sampling defaults:

dockerfile

FROM ./rwkv7-g1j-2.9b-Q4_K_M.gguf
REQUIRES 0.33.2
LICENSE """
Apache License 2.0
https://www.apache.org/licenses/LICENSE-2.0
"""
PARAMETER num_ctx 16384
PARAMETER temperature 1
PARAMETER top_k 128
PARAMETER top_p 0.5
PARAMETER frequency_penalty 0.5
PARAMETER presence_penalty 0.5
PARAMETER repeat_penalty 1
PARAMETER stop """

"""

The Modelfile intentionally does not define TEMPLATE. The GGUF files must contain the validated Jinja chat template in tokenizer.chat_template; Ollama and llama.cpp can then read it directly from the selected model. Adding an external Ollama TEMPLATE would override that embedded source of truth.

Keep the stop value on three lines as shown. Ollama 0.33.2 parses the triple-quoted blank line as two newline characters; writing the escaped text \n\n instead stores literal backslashes.

See Ollama's official guides for importing a GGUF model and the complete Modelfile reference.

Run with llama.cpp

Use a recent llama.cpp build that recognizes the rwkv7 architecture. From the directory containing the GGUF file, run:

shell

llama-cli -m rwkv7-g1j-2.9b-Q4_K_M.gguf -c 16384 -n 256 -cnv

The files were structurally validated with the locked llama.cpp GGUF tooling. Runtime validation used the included Q4KM file through Ollama; direct llama.cpp generation was not part of this release check.

Prompt format

Runtimes that honor the embedded chat template apply the format automatically. After conversion, template inspection must confirm the standard and thinking-mode prefixes before publication.

For raw completion interfaces, use one of these generation prefixes.

Standard response:

text

User: Explain why recurrent models can use constant state.

Assistant:

Thinking response:

text

User: Solve the problem step by step.

Assistant: <think>

If your runtime requires explicit stop conditions, use token ID 0 or the text sequence \n\nUser:.

Context length

Use 16,384 tokens as the release context setting. Some GGUF inspection tools may display 1,048,576 from the RWKV-7 architecture metadata; that value is an architectural capacity field, not a claim that this checkpoint was trained or validated at that length.

If your runtime cannot allocate the requested context, lower the context value. This reduces the amount of preceding text available to the model.

Model details

Field	Value
Architecture	RWKV-7 “Goose”
Checkpoint revision	G1j, released 2026-08-31
Model type	Base causal language model
Original checkpoint tensors	1,062, all BF16
Original checkpoint parameters	2,948,065,280
Expected GGUF tensor elements	2,948,229,120
Layers	32
Hidden size	2,560
FFN size	10,240
Heads / head size	40 / 64
Vocabulary size	65,536
Release context	16,384 tokens
Expected format after conversion	GGUF v3; 902 tensors
License	Apache License 2.0

The effective head count is 40 (2,560 / 64). GGUF inspectors may also show rwkv7.attention.head_count = 0; llama.cpp reserves that field but does not use it for RWKV-7.

Compatibility and troubleshooting

Symptom	What to do
The runtime reports an unknown `rwkv7` architecture	Update to a recent Ollama or llama.cpp build with RWKV-7 support.
Ollama cannot find the GGUF file	Keep `Modelfile.ollama` and the Q4KM file in the same directory, or change `FROM` to the correct path.
A valid GGUF cannot be opened from a Windows path	Move the files to a short ASCII-only path such as `C:\models\rwkv7` and try again.
The model does not follow the requested instruction	Confirm that the embedded template is active, or use the raw prompt format above. Remember that this is a base model.
The model does not fit in memory	Use Q4KM, close other memory-heavy applications, or reduce the configured context length.

Runtime support changes over time. All five files passed GGUF v3 structure, bounds, metadata, tensor-count, embedded-template, size, and SHA-256 validation. Q4KM additionally passed Ollama import, template rendering, and real generation.

Limitations

—Quantization can change model outputs, and the effect varies by task.
—This release does not claim systematic benchmark parity between quantizations.
—The model may produce inaccurate, biased, unsafe, or otherwise undesirable text.
—The model is not a substitute for qualified professional judgment in high-stakes settings.
—The presence of chat and thinking prompts does not make the base model reliably instruction-following or safety-aligned.

License

The model is distributed under the Apache License 2.0. Review the source repository and license terms before redistribution or deployment.

Citation

bibtex

@misc{peng2025250314456,
  title         = {RWKV-7 "Goose" with Expressive Dynamic State Evolution},
  author        = {Bo Peng and Ruichong Zhang and Daniel Goldstein and Eric Alcaide and Xingjian Du and Haowen Hou and Jiaju Lin and Jiaxing Liu and Janna Lu and William Merrill and Guangyu Song and Kaifeng Tan and Saiteja Utpala and Nathan Wilce and Johan S. Wind and Tianyi Wu and Daniel Wuttke and Christian Zhou-Zheng},
  year          = {2025},
  eprint        = {2503.14456v2},
  archivePrefix = {arXiv},
  primaryClass  = {cs.CL},
  url           = {https://arxiv.org/abs/2503.14456v2},
}

About RWKV-7

Choose a file

File integrity

Run with Ollama

1. Download the model

2. Create and run the Ollama model

Run with llama.cpp

Prompt format

Context length

Model details

Compatibility and troubleshooting

Limitations

License

Links

Citation