A-C-D-Matrix-FORCE: packet dissection + scan/DoS/flood detection, 250k swarm, NetLab and three labs.
136

๐ฃ Accurate Cyber Defense's Network Analyzer + Purple Hat Bot, fused with ๐ LLM-X-NetLab, ๐งฎ MATH-THE-MATRIX, ๐ก๏ธ CVE-RE, ๐ฃ sysadmin-footprint-mask, and the ๐งช sandbox-api + ๐ฏ honeyroot-x Docker images โ one force, one interface, zero dependencies.
Stack in words: ๐ Python 3.10+ (standard library ONLY) ยท ๐ณ Docker ยท โ๏ธ GitHub Actions (CI + Docker Publish) ยท ๐จ Telegram Bot API ยท ๐ Chart.js (dashboard) ยท ๐งช pytest ยท ๐ Bash
docker pull credkellar/a-c-d-matrix-force:latest
docker run --rm credkellar/a-c-d-matrix-force # demo + full checks (CHECKS 47/47)
docker run --rm credkellar/a-c-d-matrix-force python main.py council # all 6 council seats
docker run --rm credkellar/a-c-d-matrix-force python main.py chamber demo
docker run --rm credkellar/a-c-d-matrix-force python main.py honeypot report
Source: https://github.com/credkellar/A-C-D-Matrix-FORCEโ
council surface, 6 seats, names-only keys, strictest winsflowchart TD
U["๐ค You โ one command"] --> M["๐ main.py โ the ONE interface"]
M --> P["๐ฃ Analyzer + Purple Hat detector"]
M --> S["๐ 250k Swarm โ C2 approval gate"]
M --> N["๐ NetLab โ RAG / subnet / topology / tracker / live sockets"]
M --> X["๐งฎ MATH-THE-MATRIX lab"]
M --> V["๐ก๏ธ CVE-RE inventory"]
M --> F["๐ฃ Footprint mask"]
M --> C["๐งช Chamber + Honeypot"]
P --> T["๐จ Telegram alerts"]
S --> R["๐ Replay-verified report"]
P --> R
N --> R
X --> R
V --> R
F --> R
C --> R
One master diagram lives in How this works? above. Here is one flowchart per script (84 scripts):
beyond_end.pyLLM-X-NetLab โ BEYOND THE END POINT.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ stop_reason, merge_endpoints, selftest"]
B --> C["๐ค results / data out"]
conftest.pyPython module.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ module code"]
B --> C["๐ค results / data out"]
cve_re/__init__.pyCVE-RE -- static, synthetic, defensive CVE reverse-engineering lab.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ module code"]
B --> C["๐ค results / data out"]
cve_re/analyzer.pyDeterministic risk / priority triage over the CVE catalog.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ priority_score, priority_level, rank"]
B --> C["๐ค results / data out"]
cve_re/carbon4.pyGemini Carbon 4 Extended Thinking -- DECIDER seat (offline).
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ key_present, seat_status, _max_level"]
B --> C["๐ค results / data out"]
cve_re/catalog.pyCVE catalog -- data only, never exploit code.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ _r, get_record, all_ids"]
B --> C["๐ค results / data out"]
cve_re/flows.pyGoogle Flows -- ALL FOUR flows, plan-only.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ _levels, flowx_plan, workspace_studio_plan"]
B --> C["๐ค results / data out"]
cve_re/gates.pyHOLD gates -- anything live is held, never executed by this lab.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ is_held, gate_check"]
B --> C["๐ค results / data out"]
cve_re/pipeline.pyPipeline + self-checks for CVE-RE (offline, deterministic).
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ run_lab, run_checks"]
B --> C["๐ค results / data out"]
footprintmask/__init__.pysysadmin-footprint-mask โ local SysAdmin mask + digital footprint sanitizer.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ module code"]
B --> C["๐ค results / data out"]
footprintmask/blackbox.pyโ๏ธ Hash-chain blackbox log โ every plan and verdict is chained.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ BlackBox"]
B --> C["๐ค results / data out"]
footprintmask/brains.py๐ง Brains โ HOLD gates.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ Gate, evaluate"]
B --> C["๐ค results / data out"]
footprintmask/carbon4.py๐ง Gemini Carbon 4 Extended Thinking โ merged brain layer.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ carbon_status, stricter, run"]
B --> C["๐ค results / data out"]
footprintmask/flows.py๐ All the Google flows, merged โ one registry, one merged plan.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ seat_status, levels_of, flowx_plan"]
B --> C["๐ค results / data out"]
footprintmask/freeai.py๐ค freeai โ provider seat registry, NAMES ONLY.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ detected"]
B --> C["๐ค results / data out"]
footprintmask/isolation.py๐ Secure execution wrapper โ the Python model of bin/secure-exec.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ choose"]
B --> C["๐ค results / data out"]
footprintmask/profile.py๐ Shell profile rules โ the model of configs/profile.d/footprint-mask.sh.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ check_profile"]
B --> C["๐ค results / data out"]
footprintmask/sandbox.py๐ณ Ephemeral Docker sandbox โ the model of Dockerfile.sandbox.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ parse_sandbox, validate_sandbox"]
B --> C["๐ค results / data out"]
footprintmask/sanitizer.py๐งน Environment sanitizer โ the Python model of bin/sanitize-env.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ sanitize, leaks, is_sanitized"]
B --> C["๐ค results / data out"]
llmx_netlab/__init__.pyLLM-X-NetLab: the LLM-x architecture diagram merged with the computer
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ module code"]
B --> C["๐ค results / data out"]
llmx_netlab/backbone.pyLLM core backbone (poster block 3), honestly staged.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ BigramSLM"]
B --> C["๐ค results / data out"]
llmx_netlab/brains/__init__.pyPython module.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ module code"]
B --> C["๐ค results / data out"]
llmx_netlab/brains/carbon4.pyGemini Carbon 4 Extended Thinking โ the DECIDER seat.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ Carbon4"]
B --> C["๐ค results / data out"]
llmx_netlab/brains/council.pyThe council: Carbon 4 decides, Muse advises, strictest wins.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ Council"]
B --> C["๐ค results / data out"]
llmx_netlab/brains/muse.pyMuse (Meta Model API) โ the ADVISOR seat. Names-only, never overrides.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ MuseAdvisor"]
B --> C["๐ค results / data out"]
llmx_netlab/domain.pyDomain-specific modules โ the 'X' integrations (poster block 6).
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ code_interpreter, transfer_time, analyse_link"]
B --> C["๐ค results / data out"]
llmx_netlab/earth.pyGoogle Earth seat โ KML export for a tracked path.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ build_kml"]
B --> C["๐ค results / data out"]
llmx_netlab/embeddings.pyEmbedding model seat: from-scratch TF-IDF vectors + cosine similarity.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ TfidfEmbedder, cosine"]
B --> C["๐ค results / data out"]
llmx_netlab/flowvideo.pyGoogle Flow seat โ explainer-video PLANNING for networking topics.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ plan_video"]
B --> C["๐ค results / data out"]
llmx_netlab/gateway.pyMulti-modal gateway & input processing (poster block 2).
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ tokenize, Vocabulary, describe_media"]
B --> C["๐ค results / data out"]
llmx_netlab/guardrails.pyGuardrails & monitoring (poster block: support & safety layer).
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ safety_filter, redact_pii, LatencyMonitor"]
B --> C["๐ค results / data out"]
llmx_netlab/iphop.pyIP address HOPPER, TRACKER and MAPPER.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ analyse_hop, track_path, track_topology"]
B --> C["๐ค results / data out"]
llmx_netlab/kb.pyComputer-networking knowledge base, distilled from the handwritten
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ all_entries, entry_by_id, corpus_text"]
B --> C["๐ค results / data out"]
llmx_netlab/live.pyLive networking โ real sockets, online at Darion's direction (v1.1.0).
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ dns_lookup, tcp_connect, port_scan"]
B --> C["๐ค results / data out"]
llmx_netlab/memory.pyMemory systems (poster block 5).
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ SessionMemory, EpisodicMemory"]
B --> C["๐ค results / data out"]
llmx_netlab/mlops.pyMLOps & continuous learning (poster block: support layer).
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ run_benchmark, FeedbackLog"]
B --> C["๐ค results / data out"]
llmx_netlab/netlab.pyThe NetLab engines: real networking math + OFFLINE simulation.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ ip_class, subnet_info, build_topology"]
B --> C["๐ค results / data out"]
llmx_netlab/orchestrator.pyAgentic orchestrator & planner (poster block 1).
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ Orchestrator"]
B --> C["๐ค results / data out"]
llmx_netlab/rag.pyRetrieval-Augmented Generation system (poster block 4).
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ RagSystem"]
B --> C["๐ค results / data out"]
main.pyPurple-Hat Network Analyzer โ ONE interface for the merged tools.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ _print, demo, analyze"]
B --> C["๐ค results / data out"]
math_matrix/__init__.pyMATH-THE-MATRIX โ equation, medical-hypothesis and tech-invention testing lab.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ module code"]
B --> C["๐ค results / data out"]
math_matrix/brains.pyTwo-brain council โ FULL seats, names-only API keys, no live calls.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ key_present, carbon4_evaluate, muse_advise"]
B --> C["๐ค results / data out"]
math_matrix/catalog.pyEquation / formula catalog.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ Formula, _close, _pemdas"]
B --> C["๐ค results / data out"]
math_matrix/deploy.pyDeploy successful creations โ to the SANDBOX registry only.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ deploy_successful"]
B --> C["๐ค results / data out"]
math_matrix/flows.pyGoogle Flows โ ALL 4, full merged plan, plan-only (no live calls).
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ merged_plan, carbon_flow_plan, muse_flow_plan"]
B --> C["๐ค results / data out"]
math_matrix/gates.pyHOLD gates โ hard stops. Only Darion can lift one, explicitly, per action.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ check, hold_demo"]
B --> C["๐ค results / data out"]
math_matrix/labs.pyCandidate labs: medical hypotheses and tech inventions.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ Candidate, _score, generate_candidates"]
B --> C["๐ค results / data out"]
math_matrix/test_runner.pyThousands of deterministic tests.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ RunResult, run_thousands"]
B --> C["๐ค results / data out"]
php_re/__init__.pyphp_re subset โ Sandbox-API chamber + honeypot, decompressed into
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ module code"]
B --> C["๐ค results / data out"]
php_re/analyzer.pyStatic taint-style analyzer. Regex fingerprinting only -- PHP is never run.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ _find, include_graph, analyze"]
B --> C["๐ค results / data out"]
php_re/brains.pyGemini Carbon 4 Extended Thinking -- DECIDER seat (offline, names-only).
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ is_held, decide"]
B --> C["๐ค results / data out"]
php_re/carbon4.pyGemini Carbon 4 Extended Thinking -- full DECIDER seat (offline).
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ key_present, seat_status, _level_for_risk"]
B --> C["๐ค results / data out"]
php_re/flows.pyGoogle Flows -- ALL FOUR flows, plan-only, applied to BOTH brains.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ _levels, flowx_plan, workspace_studio_plan"]
B --> C["๐ค results / data out"]
php_re/honeypot.pyHoneypot -- honeyroot-x style LOG ANALYSIS ONLY.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ classify_attempt, threat_score, _bursts"]
B --> C["๐ค results / data out"]
php_re/muse_seat.pyMuse AI advisor seat -- full seat, names-only, NO decision authority.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ seat_status, _advice_items, advise"]
B --> C["๐ค results / data out"]
php_re/samples.pySynthetic PHP samples -- DATA ONLY. Never executed, never fetched.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ get_sample, sample_ids"]
B --> C["๐ค results / data out"]
php_re/sandbox.pySandbox-API -- a static triage chamber shaped like an API.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ _markers_for, triage, sandbox_demo"]
B --> C["๐ค results / data out"]
purple_analyzer/__init__.pyPurple-Hat Network Analyzer โ merged Accurate Cyber Defense tools.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ module code"]
B --> C["๐ค results / data out"]
purple_analyzer/brains.pyCouncil seats for the Purple Hat core โ added at Darion's order so
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ carbon_decide, muse_advise, flow_plan"]
B --> C["๐ค results / data out"]
purple_analyzer/config.pyConfig โ compatible with the Purple Hat Bot's config file.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ load_config, save_config, validate_ip"]
B --> C["๐ค results / data out"]
purple_analyzer/detector.pyPurple Hat threat detector โ the Purple Hat Bot half.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ Alert, Detector"]
B --> C["๐ค results / data out"]
purple_analyzer/diagnostics.pyDiagnostics โ Purple Hat Bot commands that NetLab does NOT have,
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ _run, interfaces, netstat"]
B --> C["๐ค results / data out"]
purple_analyzer/labs.pyDecompressed lab namespaces โ MATH-THE-MATRIX, CVE-RE, sysadmin-footprint-mask.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ _print, matrix_checks, matrix_dispatch"]
B --> C["๐ค results / data out"]
purple_analyzer/monitor.pyMonitor engine โ Analyzer capture + Purple Hat detection, one pipeline.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ Monitor"]
B --> C["๐ค results / data out"]
purple_analyzer/packets.pyPacket model + dissection โ the Network Analyzer half, in Python.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ protocol_for, Packet, hex_dump"]
B --> C["๐ค results / data out"]
purple_analyzer/report.pyExport & reports โ Analyzer's Data Export (JSON / CSV) + threat summary.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ packets_json, packets_csv, threat_report"]
B --> C["๐ค results / data out"]
purple_analyzer/simulator.pyDeterministic simulated packet feed.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ simulated_packets"]
B --> C["๐ค results / data out"]
purple_analyzer/swarm.py250k Agent Swarm โ the elite-firm architecture from Darion's Gemini video,
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ _mix, bot_assignment, plan_fleet"]
B --> C["๐ค results / data out"]
purple_analyzer/telegram_alert.pyTelegram alerting โ the bot's integration, on stdlib urllib.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ _post, send_alert, test_alert"]
B --> C["๐ค results / data out"]
purple_analyzer/traffic_sim.pyTraffic simulation โ the bot's generate traffic command, made safe.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ portscan_packets, dos_packets, http_flood_packets"]
B --> C["๐ค results / data out"]
tests/netlab/test_domain_models.pyPython module.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ test_kb_size, test_code_interpreter_safe_math, test_bandwidth_math"]
B --> C["๐ค results / data out"]
tests/netlab/test_iphop.pyPython module.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ test_track_start_middle_end, test_track_topology_simulated, test_map_render"]
B --> C["๐ค results / data out"]
tests/netlab/test_live.pyPython module.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ tcp_server, test_tcp_connect_open_and_closed, test_port_scan_finds_listener"]
B --> C["๐ค results / data out"]
tests/netlab/test_netlab.pyPython module.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ test_subnet_basic, test_subnet_slash16, test_topology_star_spof"]
B --> C["๐ค results / data out"]
tests/netlab/test_rag_brains.pyPython module.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ test_rag_top_hit, test_rag_graph, test_orchestrator_answers_from_notes"]
B --> C["๐ค results / data out"]
tests/test_chamber_honeypot.pyPython module.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ test_sandbox_reports_never_execute, test_sandbox_verdicts, test_sandbox_demo_counts"]
B --> C["๐ค results / data out"]
tests/test_core_brains.pyPython module.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ test_carbon_identity_and_tiers, test_carbon_dos_escalates_empty_proceeds, test_carbon_stress_single_scan_not_escalated"]
B --> C["๐ค results / data out"]
tests/test_cve_re.pyPython module.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ test_catalog_at_least_40_unique, test_catalog_required_fields_and_types, test_mandatory_records_present"]
B --> C["๐ค results / data out"]
tests/test_footprintmask.pyTests for sysadmin-footprint-mask.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ test_sanitize_purges_and_baselines, test_sanitize_does_not_mutate, test_leaks_catch_put_back_var"]
B --> C["๐ค results / data out"]
tests/test_math_matrix.pyPython module.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ test_all_formulas_verify, test_domains_cover_user_list, test_video_seed_formulas_present"]
B --> C["๐ค results / data out"]
tests/test_merged.pyPython module.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ test_sim_deterministic, test_protocols, test_hex_and_disassembly"]
B --> C["๐ค results / data out"]
tests/test_php_brains.pyPython module.
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ test_carbon4_identity, test_carbon4_stress_controls_all_pass, test_carbon4_sanitized_not_escalated"]
B --> C["๐ค results / data out"]
bin/sanitize-envShell script from sysadmin-footprint-mask (own-system use).
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ unset purge vars"]
B --> C["๐ค clean environment"]
bin/secure-execShell script from sysadmin-footprint-mask (own-system use).
flowchart LR
A["๐ฅ Input"] --> B["โ๏ธ parse session"]
B --> C["๐ค clean environment"]
--hold-demo exit 2Content type
Image
Digest
sha256:04ff6dae4โฆ
Size
42.2 MB
Last updated
3 days ago
docker pull credkellar/a-c-d-matrix-force