How trueagi-io/hyperon-experimental works
Main Components
a. Core Components:
• Rust Core Library (libhyperon.rlib)
• C API Layer (libhyperonc)
• Python Bindings (libhyperonpy)
• Python Library (hyperon)
• REPL Interfaces (Rust and Python)
b. Key Subsystems:
• MeTTa Interpreter
• Atom System
• Space System
• Runner System
• Standard Library
• Package Management System
Component Relationships
Top Layer (User Interfaces):
• MeTTa REPL (Rust)
• MeTTa REPL (Python)
• Python Applications
Middle Layer (Language Bindings):
• Python Library (hyperon)
• Python Bindings (libhyperonpy)
• C API (libhyperonc)
Core Layer (Rust Implementation):
• MeTTa Interpreter
• Atom System
• Space System
• Runner System
Specific Implementation Details
a. Core Components (Rectangle, Blue):
• Atom System (/lib/src/atom/)
• Space System (/lib/src/space/)
• MeTTa System (/lib/src/metta/)
b. Extension Points (Hexagon, Green):
• Python Extensions (/python/hyperon/exts/)
• Built-in Modules (/lib/src/metta/runner/builtin_mods/)
• Standard Library (/lib/src/metta/runner/stdlib/)
• Package Management (/lib/src/metta/runner/pkg_mgmt/)
• Common Utilities (/lib/src/common/)
• Bidirectional communication between Python bindings and C API
• How the REPL interfaces interact with the core system
• Demonstrate package management flow
• Module loading paths
Implementation Notes
• The layered architecture approach
• Clear separation between core functionality and language bindings
• Extension mechanisms for both Rust and Python
• Test infrastructure integration
Additional Elements
• Version information
• Build system integration (CMake, Cargo)
• Test framework integration
• Documentation generation flow
Remember to use the existing structure.plantuml file in the docs/assets directory as a reference point, but expand it to include the detailed architecture described above.