Foundry/docs/examples.md

CLI Tools & Examples

Production CLI tools and example programs built on Foundry.

---

Production CLI Tools

Tool	Description	Docs
rwkvx_generate	RWKV-X text generation (INT8, HybridMem)	rwkvx-generate.md
rwkvx_train	RWKV-X LoRA training (moba blocks)	rwkvx-train.md
rfa_generate	RFA hybrid text generation (RWKV-7 + Qwen)	rfa-generate.md
rfa_train	RFA hybrid LoRA training (parallel, INT8)	rfa-train.md
rfa_lora_merge	LoRA adapter averaging (cross-machine merge)	rfa-lora-merge.md

---

Build All Tools

# RWKV-X inference + training
make clean && make USE_BLAS=1 rwkvx-generate rwkvx-train

# RFA hybrid inference + training + merge
make clean && make USE_BLAS=1 rfa-generate rfa-train rfa-lora-merge

---

Research & Test Programs

Located in examples/ but not intended for production use:

Program	Description
train_mlp.c	Simple MLP training demo
bench_hybridmem.c	HybridMem performance benchmark
test_hdc_correlation.c	HDC vector correlation test
test_hybridmem_retrieval.c	HybridMem retrieval accuracy test
test_pooling_loss.c	Mean-pool vs token embedding loss
test_query_vector.c	HDC query vector generation
test_attn_weights.c	Attention weight distribution analysis
test_context_scaling.c	Context length scaling test
test_eviction_boundary.c	KV cache eviction boundary test
test_false_positive.c	HDC false positive rate test
test_filler_sensitivity.c	Filler token sensitivity test
test_multi_fact.c	Multi-fact retrieval test
test_precision_at_scale.c	Precision at scale test
test_rosa_db_index.c	ROSA suffix automaton indexing test
test_rosa_db_qa.c	ROSA question-answering test
test_rosa_db_retrieve.c	ROSA retrieval quality test