mirror of
https://github.com/Mesh-LLM/mesh-llm.git
synced 2026-08-08 22:23:19 -04:00
| .. | ||
| design | ||
| plans | ||
| plugins | ||
| sdk | ||
| skippy | ||
| specs | ||
| AGENTS.md | ||
| BENCHMARKS.md | ||
| CLI.md | ||
| CODESIGNING.md | ||
| cuda-release-lanes.md | ||
| EXO_COMPARISON.md | ||
| LAYER_PACKAGE_REPOS.md | ||
| mesh-llm-wordmark.png | ||
| mesh.png | ||
| MESHES.md | ||
| NODE_REP.md | ||
| README.md | ||
| SDK.md | ||
| SKIPPY.md | ||
| SKIPPY_SPLITS.md | ||
| SWARM_CAPTURE.md | ||
| USAGE.md | ||
Documentation
Use this hub to find project guides that are not owned by a single Rust crate.
Start here
| Need | Doc |
|---|---|
| Install, run, service mode, model storage | USAGE.md |
| Private meshes, published meshes, public joining | MESHES.md |
| Local routing reputation and target cooldowns | NODE_REP.md |
| SDK usage, examples, errors, lifecycle, platform support | SDK.md |
| Language-specific SDK examples | Rust, Node.js, Swift, Kotlin/Android |
| Run big models with Skippy layer splits | SKIPPY_SPLITS.md |
| Contribute or publish layer package repositories | LAYER_PACKAGE_REPOS.md |
| Goose, Claude Code, OpenCode, Pi, curl, blackboard | AGENTS.md |
| Command-by-command CLI reference | CLI.md |
| Exo comparison | EXO_COMPARISON.md |
Skippy and model-package docs
| Doc | What it covers |
|---|---|
| skippy/FAMILY_STATUS.md | Certified family/split/wire-dtype status |
| skippy/NEW_MODEL_ONBOARDING.md | New-model split/certification intake checklist |
| skippy/FAMILY_CERTIFY.md | Certification workflow for new families |
| skippy/TOPOLOGY_PLANNER.md | Stage topology planning behavior |
| skippy/CONFIGURATION.md | Authoritative operator matrix for Skippy config keys and rejection boundaries |
| skippy/PROMPT_CACHE.md | OpenAI prompt-prefix cache behavior, defaults, telemetry, and benchmark flow |
| skippy/DATA_FLOW.md | Stage data flow and transport details |
| skippy/LLAMA_PARITY.md | Remaining llama.cpp parity queue |
| specs/layer-package-repos.md | Manifest schema and package artifact rules |
| specs/mesh-setup-installer.md | Bootstrap installer and mesh-llm setup ownership boundary |
| SKIPPY.md | Skippy integration readiness and parity notes |
Use SKIPPY_SPLITS.md for Skippy split-serving workflows.
Other references
| Doc or directory | What belongs there |
|---|---|
| BENCHMARKS.md | Current benchmark numbers and performance context |
| SWARM_CAPTURE.md | Opt-in local debug capture for mesh membership and connection diagnostics |
| design/ | Architecture notes, protocol design, testing playbooks, carried llama.cpp patch documentation |
| design/NATIVE_RUNTIMES.md | Native runtime artifact packaging, exact version matching, resolver behavior, and SDK/autoupdater ownership |
| design/NODE_OWNER_IDENTITY.md | Owner identity, trust policy, and how owner trust stays separate from release attestation |
| design/EMITTER_HOOKS.md | Inventory of hook, callback, and emitter surfaces plus readiness ownership. |
| plugins/ | Plugin architecture and implementation planning |
| plans/ | Narrow implementation plans that are not yet general design docs |
| specs/ | Focused behavior specs for individual features |
| design/OPENAI_GUARDRAILS.md | OpenAI guardrail rollout defaults, v1 limits, telemetry privacy, and evidence scaffolding |
Per-crate docs stay with their crates. The main binary crate overview lives at ../crates/mesh-llm/README.md, and the web console/embedded asset crate overview lives at ../crates/mesh-llm-ui/README.md. Shared protocol-facing model/type ownership lives at ../crates/mesh-llm-types/README.md. Shared owner identity and envelope crypto lives at ../crates/mesh-llm-identity/README.md. Shared wire protocol ownership lives at ../crates/mesh-llm-protocol/README.md. Shared routing target ownership lives at ../crates/mesh-llm-routing/README.md.