Spark

Spark factory documentation (hub)

Engineer map for the Spark / SparkLang SPARK_BC factory on sparklang.dev. Does not reimplement SGD, attention, or serve APIs — links code + makefile targets. Eval and train scores are measurement only, not marketing wins.

Reproduction story: SPARK_BC Builder. Diagrams: Diagrams — tool map, shadows, LLM assist vs deterministic SoT. AI model aspects: Model aspects — behaviors, ears/STT, eyes/vision, speaking/TTS, thinking, memory, tools, train, eval, serve. AI knowledge hive: Knowledge — engineer-grade field explainers (transformers → safety) with original diagrams.

Map (everything)

Topic Doc Site
AI knowledge hive Knowledge /docs/knowledge.html
AI model aspects Model aspects /docs/model-aspects.html
Voice / STT / TTS VOICE.md /docs/voice.html
Voice ask (dump Q&A) VOICE_ASK.md /docs/voice-ask.html
Voice easy train Voice easy /docs/voice-easy.html
Diagrams (tools + LLM) Diagrams /docs/diagrams.html
Compile / assemble COMPILE.md /docs/compile.html
Decompile / dump / inspect Decompile /docs/decompile.html
Decompile compete / scoreboard DECOMPILE_COMPETE.md /docs/decompile-compete.html
LLM decompile research research/LLM_DECOMPILE.md /docs/llm-decompile.html
Opcode ISA (TRAIN/STEP/…) SPARK_BC.md /docs/spark-bc.html
Build models + weights BUILD_MODELS.md /docs/build-models.html
Train loop (outer/inner) Train loop /docs/train-loop.html
Architecture pieces Architecture /docs/architecture.html
Weight gallery Weight gallery /docs/weight-gallery.html
Attention / MLP status Attention / forward /docs/attention-forward.html
Tokenizer / BPE TOKENIZER.md /docs/tokenizer.html
Serve forward + HTTP Serve /docs/serve.html
Eval harness Eval /docs/eval.html
Spark coder (owned) Spark coder /docs/spark-coder.html
Makefile targets SPARKBC_MAKE.md /docs/sparkbc-make.html
Tools & helpers TOOLS_HELPERS.md /docs/tools-helpers.html
Methods vs OpenBin Methods vs OpenBin /docs/methods-openbin.html
CI + Pages how-to CI_PAGES.md /docs/ci-pages.html
Full factory E2E SPARK_BC Builder /docs/spark-builder.html
Adoption bar ADOPTION_BAR.md /docs/adoption-bar.html

Quick start (stranger with the repo)

make spark-bootstrap spark
        make test-sparkbc
        make sparkbc-e2e
        make spark-sgd-proof
        make spark-eval
        make docs-check