{"id":50462003,"url":"https://github.com/codex-curator/codex-lab-kit","last_synced_at":"2026-06-01T05:00:51.558Z","repository":{"id":339093515,"uuid":"1158918106","full_name":"codex-curator/codex-lab-kit","owner":"codex-curator","description":"Codex Lab Kit — Standardized validation toolkit for hash-based robotic manipulation (Apache 2.0)","archived":false,"fork":false,"pushed_at":"2026-03-14T11:08:46.000Z","size":49,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-14T22:10:21.584Z","etag":null,"topics":["benchmark","experiment-protocol","perceptual-hashing","python","robotics","testing","validation"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codex-curator.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-16T04:43:07.000Z","updated_at":"2026-03-14T11:08:49.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/codex-curator/codex-lab-kit","commit_stats":null,"previous_names":["codex-curator/codex-lab-kit"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/codex-curator/codex-lab-kit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codex-curator%2Fcodex-lab-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codex-curator%2Fcodex-lab-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codex-curator%2Fcodex-lab-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codex-curator%2Fcodex-lab-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codex-curator","download_url":"https://codeload.github.com/codex-curator/codex-lab-kit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codex-curator%2Fcodex-lab-kit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33760658,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-01T02:00:06.963Z","response_time":115,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["benchmark","experiment-protocol","perceptual-hashing","python","robotics","testing","validation"],"created_at":"2026-06-01T05:00:48.450Z","updated_at":"2026-06-01T05:00:51.550Z","avatar_url":"https://github.com/codex-curator.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Codex Lab Kit\n\nStandardized validation toolkit for the **Golden Codex Protocol** — a patent-pending dual-path architecture for robotic manipulation.\n\n[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-green.svg)](LICENSE)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18668110.svg)](https://doi.org/10.5281/zenodo.18668110)\n\n`Apache 2.0` | `Python 3.9+` | `Seeking Validation Partners`\n\n## Overview\n\nThis toolkit enables robotics labs to run standardized validation experiments testing whether **perceptual hashing** can serve as the primary recognition layer for manipulation tasks.\n\nThe underlying Golden Codex Protocol combines O(1) hash lookup for known objects with LLM-based recovery for novel encounters. This public kit provides everything needed to run experiments and collect structured data — the proprietary core engine is available separately to approved partners.\n\n## What's Included\n\n| Package | Description |\n|---------|-------------|\n| `codex_lab_kit/` | Experiment protocol generator, structured data collector (CSV), statistical analysis, hardware calibration wizard |\n| `codex_mock_ros/` | Lightweight mock ROS2 framework — pub/sub, services, action servers — for testing without ROS2 installed |\n| `codex_msgs/` | Standard ROS2 message, service, and action definitions for the Golden Codex pipeline |\n| `docs/` | Protocol walkthrough, lab onboarding guide, data format reference |\n| `examples/` | Standalone demo using only public modules (zero core dependencies) |\n\n## Quick Start\n\n```bash\npip install codex-lab-kit\n```\n\n```python\nfrom codex_lab_kit import ExperimentProtocol, DataCollector, ResultsAnalyzer\n\n# Generate the 4-phase experiment protocol\nprotocol = ExperimentProtocol(lab_name=\"My Lab\", robot_model=\"Franka Panda\")\nprotocol.export_protocol(\"experiment_protocol.json\")\n\n# Collect trial data\ncollector = DataCollector(lab_name=\"My Lab\")\ncollector.record(\n    phase_id=\"A\", trial_index=0, object_id=\"001_chips_can\",\n    query_dhash=\"0xabcdef1234567890\", match_type=\"EXACT\",\n    hamming_distance=0\n)\ncollector.export_csv(\"results.csv\")\n\n# Analyze results\nanalyzer = ResultsAnalyzer(\"results.csv\")\nreport = analyzer.export_report(\"analysis_report.json\")\n```\n\n## Experiment Protocol\n\nThe validation protocol consists of four phases testing different aspects of hash-based robotic manipulation:\n\n| Phase | Name | Trials | Hardware Required | Duration |\n|-------|------|--------|-------------------|----------|\n| **A** | Hash Robustness | 360 images | Camera + YCB objects | ~50 min |\n| **B** | Hash-to-Grasp Correlation | 100 grasps | Robot + gripper + force sensor | ~200 min |\n| **C** | Loop Closure Convergence | 250 trials | Robot + 5 novel objects | ~250 min |\n| **D** | Latency Profile | timing | Full pipeline | ~30 min |\n\nPhase A can be run with camera-only setups. Phases B-D require a manipulation platform (Franka Panda, UR5e, or similar).\n\nSee [docs/experiment_protocol.md](docs/experiment_protocol.md) for the full walkthrough.\n\n## For Partner Labs\n\nWhat you receive as a validation partner:\n\n- Complete Python validation toolkit (pip-installable)\n- Standardized experiment protocol with step-by-step instructions\n- Pre-computed hash baselines for 20 YCB objects\n- Structured data collector (ROS2 node or standalone)\n- Automated analysis and visualization scripts\n- **Co-authorship on resulting publications**\n- Access to aggregated cross-lab results\n- Custom dataset generation tools for novel objects\n\n## Core Engine\n\nThe proprietary `gcp-robotics` core package — containing the composite hash engine, Spatial Kinematic Blueprint schema, O(1) registry, and LLM slow path generator — is available to approved academic partners under individual license agreements.\n\n```bash\n# For approved partners only\npip install codex-lab-kit[core]\n```\n\nContact **research@iaeternum.ai** for access.\n\n## Patent Notice\n\nThe Golden Codex Protocol architecture is the subject of U.S. Provisional Patent Applications No. 63/983,304, No. 63/984,299, and No. 63/985,213, assigned to Metavolve Labs, Inc.\n\n## Citation\n\n```bibtex\n@software{codex_lab_kit,\n  title    = {Codex Lab Kit: Validation Toolkit for Hash-Based Robotic Manipulation},\n  author   = {MacPherson, Tad},\n  year     = {2026},\n  publisher = {Zenodo},\n  doi      = {10.5281/zenodo.18668110},\n  url      = {https://doi.org/10.5281/zenodo.18668110}\n}\n```\n\n## Research Papers\n\n| # | Paper | DOI |\n|---|-------|-----|\n| 1 | The Entropy of Recursion | [10.5281/zenodo.18436975](https://doi.org/10.5281/zenodo.18436975) |\n| 2 | The Density Imperative | [10.5281/zenodo.18667735](https://doi.org/10.5281/zenodo.18667735) |\n| 3 | Cognitive Nutrition for Foundation Models | [10.5281/zenodo.18667742](https://doi.org/10.5281/zenodo.18667742) |\n| 4 | Perceptual Compute Offloading | [10.5281/zenodo.18667749](https://doi.org/10.5281/zenodo.18667749) |\n\n## Links\n\n- **Website:** [iaeternum.ai/robotics](https://iaeternum.ai/robotics)\n- **GCP-Robotics SDK:** [github.com/codex-curator/gcp-robotics](https://github.com/codex-curator/gcp-robotics)\n- **Alexandria Dataset:** [HuggingFace](https://huggingface.co/datasets/Metavolve-Labs/alexandria-aeternum-genesis) | [DOI: 10.5281/zenodo.18359131](https://doi.org/10.5281/zenodo.18359131)\n- **Contact:** research@iaeternum.ai\n- **License:** Apache 2.0 (this toolkit) | Proprietary (core engine)\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on submitting code, running experiments, and contributing datasets.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodex-curator%2Fcodex-lab-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodex-curator%2Fcodex-lab-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodex-curator%2Fcodex-lab-kit/lists"}