Swarm-intelligence and adaptive routing protocols for MANETs and LEO constellations, implemented cleanly on ns-3 and benchmarked against each other on identical seeds.
The org grew out of AntHocNet (Di Caro, Ducatelle & Gambardella, 2005), the source repository, which now lives here too: its shared infrastructure, comparator arms and benchmark tooling are moving into their own repositories so each protocol can be its own citable repository.
The last two columns are live: each repository's SonarQube Cloud quality gate and its Codecov line coverage (report-only, uploaded by CI from the repository's own code). A dash means not measured yet: no code, or no analysis set up.
| Repository | What it is | Quality gate | Coverage |
|---|---|---|---|
| ns3-containers | ghcr.io/swarm-routing/ns3-dev images: ns-3 pre-built (debug / sanitized / optimized), contrib modules compile in seconds |
— | |
| ns3-swarm-core | The swarm-core contrib module: shared primitives (visited path, LE codecs, pheromone table, route decision) and ns-3 cross-layer glue |
 |
|
| ns3-tools | Diagnostic probes, comparison arenas, the ns3-tool CLI (sweep, compare, diagnose, scaffold) |
 |
|
| ARA | Ant-Colony-Based Routing Algorithm (Güneş et al., 2002) | — | |
| BeeAdHoc | Honeybee routing (Wedde & Farooq, 2005) | — | |
| Termite | Stigmergic routing in data packets, no control ants (Roth & Wicker, 2003/2005). No code yet; Phase 5 pre-work open | — | |
| HOPNET | Ant routing over zones (Wang, 2007). No code yet; not scheduled | — | — |
| benchmarks | Immutable 20-seed datasets, paired verdicts, reproducibility manifests | — | — |
| swarm-routing.github.io | Colony Arena: interactive docs, visualizers, leaderboard | — | |
| AntHocNet | The reference AntHocNet implementation, the colony the org grew out of |  |
The org is set up for people and AI agents to work side by side: every
repository has an AGENTS.md (its rules, how to build and verify) and every
open sub-issue of an epic carries a priority:* and a model:* label.
Choose an epic, take one of its open sub-issues, and follow the repository's
AGENTS.md. What is already done, per repository:
ROADMAP.md, Epics.
Starting a fresh session, or handing work to an AI chat? Every workstream has
a handoff issue
written for a reader with no history: the goal, the state, the next steps in
order, the commands and the pitfalls. The ROADMAP's
Where to start
lists them in the order that matters.
| Repository | Epic | Status | Sub-issues closed |
|---|---|---|---|
| .github | #6 org repo template — security policy, README badges and community files, applied and kept in sync by a tool and a skill | In progress | 12 / 28 |
| .github | #14 Repository hardening for every org repo: Scorecard, rulesets, merge policy, CI hygiene | In progress | 2 / 11 |
| .github | #50 One repository per swarm protocol: create the missing ones (Termite, HOPNET) | In progress | 2 / 3 |
| .github | #107 ns-3 images: every protocol release and campaign builds on ns3-containers | In progress | 2 / 7 |
| .github | #35 code quality across the org — order of work and maintainer decisions | Planned | no sub-issues yet |
| .github | #48 Other simulators: container and tooling repos for OMNeT++/INET, Veins and CORE/EMANE (deferred; ns-3 first) | Planned | no sub-issues yet |
| AntHocNet | #64 Abstract discrete-event testbench in core/tests — trend regression without a simulator | In progress | 1 / 2 |
| AntHocNet | #109 Publish the AntHocNet implementation (reproducibility + cross-simulator paper) | In progress | 1 / 4 |
| AntHocNet | #328 5-star open-source packaging — visibility, supply-chain trust, onboarding, docs site | In progress | 13 / 23 |
| AntHocNet | #32 Add an OMNeT++/INET adapter (third simulator target) | Planned | 0 / 4 |
| AntHocNet | #65 CORE/EMANE emulation target — run the real core as a Linux daemon | Planned | 0 / 3 |
| AntHocNet | #194 Make the NS-3 adapter satellite-capable (multi-interface, timescales, non-wifi signals) | Planned | no sub-issues yet |
| AntHocNet | #302 secured AntHocNet — attribute-gated trust + authenticated ants, default-off and byte-identical to the paper-faithful path | Planned | no sub-issues yet |
| AntHocNet | #564 Wider threat model (v3.3.0): wormhole, rushing, Sybil and pheromone poisoning | Planned | 0 / 4 |
| ARA | #3 ARA as a standalone hexagonal protocol (Phase 3) | In progress | 2 / 3 |
| HOPNET | #3 HOPNET as a standalone hexagonal protocol (later: not scheduled) | In progress | 1 / 3 |
| ns3-containers | #19 OS and compiler coverage — the platforms ns-3 supports and researchers use | In progress | 2 / 6 |
| ns3-containers | #36 image test pipeline — every image built is tested by digest (security, structure, unit, profile, integration, regression, downstream) before any tag moves | In progress | 5 / 9 |
| ns3-containers | #11 multi-platform ns3-dev images (linux/amd64 + linux/arm64) with docker buildx | Planned | no sub-issues yet |
| ns3-containers | #12 developer documentation for the ns3-dev images (usage, per-image pages, debugging, CI/CD) kept current by AI review | Planned | 0 / 7 |
| ns3-containers | #27 security refresh — keep the supported ns-3 release's images patched (scheduled base refresh + scan-triggered rebuilds; older releases on demand) | Planned | 0 / 4 |
| ns3-swarm-core | #6 swarm-core: the shared contrib module every swarm protocol links (Phase 2) | In progress | 3 / 8 |
| ns3-tools | #2 A protocol-agnostic comparison harness, packaged on its own | Planned | 0 / 8 |
| ns3-tools | #7 metrics 2026 — age of information, delay percentile/CDF export, energy-per-bit, route lifetime/convergence as CSV metrics | Planned | 0 / 1 |
| ns3-tools | #15 Comparators: swarm, learned and secure protocols under identical conditions | Planned | 0 / 10 |
| ns3-tools | #34 promote AntHocNet's vendored comparator modules into ns3/arms/: aomdv, gpsr, qrouting, oracle | Planned | 0 / 2 |
| ns3-tools | #43 Network substrates: the ns-3 pieces new network types need, for every arm | Planned | 0 / 10 |
| skills | #9 Protocol-development and org-ops skills: fidelity sheets, invariant review, module scaffolds, anchors, handoffs | In progress | 3 / 8 |
| swarm-routing.github.io | #3 Colony Arena: the one org site, built from the protocol repos | In progress | 5 / 7 |
| swarm-routing.github.io | #21 Campaign mode: one chapter per network type, with a game UI | Planned | 0 / 2 |
| swarm-routing.github.io | #27 Colony Arena polish: navigation, SEO, usability, search | Planned | 0 / 10 |
| Termite | #3 Termite as a standalone hexagonal protocol (Phase 5) | Planned | 0 / 3 |
Every implemented protocol is deterministic for a fixed seed and compared by
paired per-seed deltas over ≥ 20 seeds. Licensing follows AntHocNet: each
simulator-free core/ and the standalone tooling are MIT OR GPL-2.0-only;
ns-3 modules, sites, docs and data are GPL-2.0-only. Plan: ROADMAP.md.
Conventions:
CONTRIBUTING.md.
Support the work: sponsor @danieljoppi (it keeps the ns-3 images, CI and benchmark campaigns running), or cite AntHocNet's DOI.