OpenCantorAI

One checkout → the whole CantorAI stack. OpenCantorAI is a wrapper repository that pulls together the four core building blocks of CantorAI—Cantor, Galaxy, GalaxyStudio, and XLang—as Git submodules, adds a thin layer of build scripts and container tooling, and delivers a turnkey edge‑to‑cloud AI platform you can compile, test, and run on anything from Raspberry Pi Pico to multi‑GPU servers.

---

✨ Why this repo exists

Pain point	What OpenCantorAI gives you
Scattered upstream projects	One place to clone and version‑lock Cantor, Galaxy, GalaxyStudio, and XLang
Divergent build systems	Unified CMake + Docker workflow with sane defaults
On‑ramp friction	./bootstrap.sh seeds submodules, fetches third‑party deps, and launches the stack
Heterogeneous targets	Cross‑compilation presets (armv7, aarch64, x86_64, bare‑metal Pico)
Manual demo wiring	Reference SC24 Demo pipeline: vision ➜ LLM ➜ speech in <60 s

---

🗂️ Repository layout

OpenCantorAI/
├─ .github/           # CI, issue templates
├─ bootstrap.sh       # 1‑click submodule + toolchain setup
├─ docker/            # Container recipes (dev, runtime, CI)
├─ cmake/             # Common CMake helpers / toolchains
├─ demos/             # End‑to‑end examples (vision, LLM, hybrid)
├─ cantor/    (submodule)  # Distributed compute + scheduler
├─ galaxy/    (submodule)  # Media/vision engines, DXGI/GStreamer bridges
├─ galaxystudio/ (submodule)  # Visual pipeline editor / IDE
└─ xlang/     (submodule)  # Scripting language & std‑lib

---

🚀 Quick start

1. Clone with submodules

git clone --recursive https://github.com/your-org/OpenCantorAI.git
cd OpenCantorAI

2. Build natively (x86‑64 Linux)

mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build . --parallel

3. Or spin up a dev container

docker compose -f docker/dev.yml up --build
# opens VS Code‑Server on http://localhost:8080 (see docs/tools.md)

4. Run the reference pipeline

./demos/sc24_demo/run.sh

---

🔧 Cross‑compilation presets

• Raspberry Pi OS / 64‑bit: toolchain-rpi64.cmake
• Raspberry Pi Pico (bare‑metal): toolchain-pico.cmake
• Windows + MSVC: bootstrap.ps1 → Visual Studio solution
• macOS (Apple Silicon): toolchain-macos-arm64.cmake

---

🏗️ CI / CD

Provider	Job	Trigger
GitHub Actions	Unit + integration tests on Ubuntu, Windows, macOS	PR / main
GitHub Actions	Docker images (dev, runtime) pushed to ghcr.io	main
GitHub Actions	Nightly cross builds for armv7 + aarch64	cron

---

📜 Licensing

All original glue code in this repository is released under GNU General Public License v3.0 (GPL‑3.0). Each submodule retains its upstream license; see their respective LICENSE files.

---

🤝 Contributing

1. Fork & branch from main
2. Run ./scripts/pre-commit.sh (clang‑format, pylint, license header check)
3. Submit a PR—one feature or fix per PR, please.
4. Join the discussion on GitHub Discussions.

We follow the Contributor Covenant Code of Conduct.

---

🗺️ Roadmap (2025 H1)

• Galaxy‑Lite: WebAssembly build for browser inference
• Cantor v2: Federated scheduling + node attestation
• XLang: Rust FFI & import_process zero‑copy IPC
• SC24 Demo++: Voice commands + Pico‑controlled actuators

Have an idea or a feature request? Open an issue and let’s build the future of distributed AI together! 🚀