Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

ProtoXCode/Atlas-Protocol

Repository files navigation

🌐 Atlas Protocol

"We don’t fix the problem. We fix the reason the problem exists."

Atlas Protocol is a modular, intent-driven digital design framework that flips the entire design paradigm.
Instead of designing parts and retrofitting them into systems, Atlas starts from intent and builds outward β€” generating digital twins, ripple-aware revisions, ERP integration, and Git-style versioning for the physical world.


πŸš€ What is Atlas?

Atlas isn’t just a tool β€” it’s a protocol for co-creating modular systems from input logic, material constraints, and ripple-safe propagation.

  • Twin-first design (not model-last)
  • Intent-based geometry generation
  • Full part/assembly version control (via Enigma)
  • Ripple conflict detection + auto-adjustment (via BOMBE)
  • ERP-aware stock logic and BOM completion (via Relay)
  • Real-world material availability forecasting (via Caladan)
  • Performance comparison and stress testing (via Gauntlet)

1 million cubes


βš™οΈ Getting Started

Windows:

git clone hhttps://github.com/ProtoXCode/Atlas-Protocol.git
pip install -r requirements.txt
python main.py

Linux (Tested on Fedora 42):

git https://github.com/ProtoXCode/Atlas-Protocol.git
pip install -r requirements.txt
bash tools/setup_linux.sh
python main.py

βš™οΈ Development Status

  • OCC Wrapper
    Built with Pybind11, currently functional with core modeling tools (box, fuse, cut, translate, etc.).
    Provides direct access to OpenCascade geometry from Python without external dependencies like Conda.

  • GUI
    PySide6 + VTK viewer now renders geometry directly from Python modules (no intermediate STL/STEP files needed).
    Live rescan function allows hot-loading of model modules from the /models directory.

GUI

πŸ”œ Next Steps

  • Expand OCC wrapper with advanced modeling operations (sheet metal bends, fastener library, etc.).
  • Integrate automatic model scanning and intent parsing for richer model metadata.
  • Add card-style panels, theme support, and more interactive GUI controls.
  • Implement export pipelines for STEP, DXF, and drawing generation directly from the viewer.

πŸ“ Key Modules

Module Purpose
Enigma Git-style versioning for parts and assemblies
BOMBE Ripple analysis + auto-conflict resolution
Titan Constraint-based orchestrator for large-scale design systems
Relay ERP interface for BOM matching and stock-aware completion
Caladan Material tracking + disruption awareness
Gauntlet Comparative twin testing + benchmarking
Atlas Protocol Interface Exploded views, ripple shadows, part launching

πŸ“¦ Features

  • πŸ“ CAD-agnostic design output
  • 🌍 Modular API architecture
  • πŸ”„ Git-style branching and forking
  • πŸ“Š Auto-generated BOM from full twin model
  • 🧠 Open-source logic, AI-ready for future expansion
  • 🧩 Open innovation + commercial dual-license model

πŸ“œ License

Atlas is released under the Atlas Liberation License (ALL):

  • πŸ†“ Free for non-commercial, educational, and research use
  • πŸ’Ό Commercial use requires registration or licensing
  • 🚫 Prohibited for oppression, mass surveillance, or civilian-targeted weaponization
  • πŸ” Redistribution must preserve open terms and author credit

β†’ Full license: LICENSE.txt

⚠️ Third-Party Notice

Atlas Protocol uses Open CASCADE Technology (OCCT) for CAD kernel functionality.
OCCT is licensed under the LGPL v2.1 with an additional exception.

  • Full license texts are included in third_party/
  • Atlas remains licensed under the Atlas Liberation License (ALL)
  • OCCT continues to be licensed under its own terms

πŸ“£ Get Involved

Atlas is a system. A language. A mindset. It’s built to grow β€” and so are you.

  • πŸ›  Clone the repo, try the demo, run test modules
  • 🧩 Contribute logic templates, intent metadata, or ERP bindings
  • πŸ”— Connect Atlas to your CAD, MES, or simulation systems
  • 🌍 Join the ACE (Atlas Community Edition) movement

πŸ“š Resources


"Digital twins today are copies. Atlas is the origin."

About

Atlas Protocol: A Ripple-Aware, Intent-Driven Design Framework for the Modular Age

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

Contributors

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /