{"id":30160078,"url":"https://github.com/cschladetsch/cppkai","last_synced_at":"2025-08-11T15:25:58.014Z","repository":{"id":18354156,"uuid":"21534145","full_name":"cschladetsch/CppKAI","owner":"cschladetsch","description":"KAI is a distributed computing model written in modern C++. Using custom language translators and an executor, KAI provides full reflection, persistence and cross-process communications without having to modify existing source code. KAI Comes with an automated, generational tricolor garbage collector, and Console- and Window-based interfaces.","archived":false,"fork":false,"pushed_at":"2025-08-04T16:01:50.000Z","size":84026,"stargazers_count":14,"open_issues_count":7,"forks_count":4,"subscribers_count":4,"default_branch":"develop","last_synced_at":"2025-08-04T18:12:06.944Z","etag":null,"topics":["ast-walker","c-plus-plus","cmake","cpp","kai","language","lexer","networking","parser","raknet","stack","tests"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cschladetsch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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}},"created_at":"2014-07-06T05:23:56.000Z","updated_at":"2025-08-04T16:01:54.000Z","dependencies_parsed_at":"2022-09-18T22:51:18.842Z","dependency_job_id":"ea8203fa-bf47-41b1-aa25-d91261a4f87d","html_url":"https://github.com/cschladetsch/CppKAI","commit_stats":null,"previous_names":["cschladetsch/cppkai"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/cschladetsch/CppKAI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cschladetsch%2FCppKAI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cschladetsch%2FCppKAI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cschladetsch%2FCppKAI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cschladetsch%2FCppKAI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cschladetsch","download_url":"https://codeload.github.com/cschladetsch/CppKAI/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cschladetsch%2FCppKAI/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269912777,"owners_count":24495403,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-11T02:00:10.019Z","response_time":75,"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":["ast-walker","c-plus-plus","cmake","cpp","kai","language","lexer","networking","parser","raknet","stack","tests"],"created_at":"2025-08-11T15:25:53.170Z","updated_at":"2025-08-11T15:25:58.005Z","avatar_url":"https://github.com/cschladetsch.png","language":"C++","readme":"# KAI - Distributed Object Model for C++ ![Image](Images/kai_logo.png)\n\n[![Build status](https://ci.appveyor.com/api/projects/status/github/cschladetsch/kai?svg=true)](https://ci.appveyor.com/project/cschladetsch/kai)\n[![CodeFactor](https://www.codefactor.io/repository/github/cschladetsch/kai/badge)](https://www.codefactor.io/repository/github/cschladetsch/kai)\n[![License](https://img.shields.io/github/license/cschladetsch/flow.svg?label=License\u0026maxAge=86400)](./LICENSE)\n\n_KAI_ is a network distributed **Object Model** for C++ with full runtime reflection, persistence, and incremental garbage collection. No macros are needed to expose fields or methods to the scripting runtime, including external code from other libraries.\n\nObjects and *compute* can be distributed across Nodes in a Domain.\n\n## System Architecture Overview\n\nThe KAI system provides a multi-layered architecture that enables distributed object programming with multiple language frontends:\n\n```mermaid\ngraph TB\n    subgraph \"Application Layer\"\n        USER[User Applications]\n        SCRIPTS[Scripts \u0026 Automation]\n        TOOLS[Developer Tools]\n    end\n    \n    subgraph \"Language Layer\"\n        RHO[Rho Language\u003cbr/\u003eInfix Syntax\u003cbr/\u003ePython-like]\n        PI[Pi Language\u003cbr/\u003eStack-based\u003cbr/\u003eForth-like]\n        TAU[Tau Language\u003cbr/\u003eInterface Definition\u003cbr/\u003eCode Generation]\n    end\n    \n    subgraph \"Console \u0026 Networking\"\n        CONSOLE[Interactive Console\u003cbr/\u003eMulti-language REPL]\n        P2P[Peer-to-Peer\u003cbr/\u003eConsole Networking]\n        NETCMD[Network Commands\u003cbr/\u003eRemote Execution]\n    end\n    \n    subgraph \"Execution Engine\"\n        EXECUTOR[Stack-based Executor\u003cbr/\u003eVirtual Machine]\n        COMPILER[Multi-language\u003cbr/\u003eCompiler/Translator]\n        CONTINUATION[Continuation Support\u003cbr/\u003eAdvanced Control Flow]\n    end\n    \n    subgraph \"Core Object Model\"\n        REGISTRY[Type Registry\u003cbr/\u003eObject Factory\u003cbr/\u003eReflection System]\n        OBJECTS[Distributed Objects\u003cbr/\u003eNetwork Transparency]\n        GC[Incremental GC\u003cbr/\u003eTri-color Algorithm]\n    end\n    \n    subgraph \"Platform \u0026 Runtime\"\n        MEMORY[Memory Management\u003cbr/\u003eSmart Pointers]\n        SERIALIZE[Serialization\u003cbr/\u003eNetwork Protocol]\n        PLATFORM[Cross-platform\u003cbr/\u003eWindows/Linux/macOS]\n    end\n    \n    subgraph \"External Dependencies\"\n        BOOST[Boost Libraries]\n        RAKNET[RakNet Networking]\n        GTEST[Google Test]\n        CMAKE[CMake Build]\n    end\n    \n    %% Application connections\n    USER --\u003e RHO\n    USER --\u003e PI  \n    USER --\u003e TAU\n    SCRIPTS --\u003e CONSOLE\n    TOOLS --\u003e CONSOLE\n    \n    %% Language layer connections\n    RHO --\u003e COMPILER\n    PI --\u003e EXECUTOR\n    TAU --\u003e COMPILER\n    \n    %% Console connections\n    CONSOLE --\u003e EXECUTOR\n    CONSOLE --\u003e P2P\n    P2P --\u003e NETCMD\n    NETCMD --\u003e EXECUTOR\n    \n    %% Execution engine connections\n    COMPILER --\u003e EXECUTOR\n    EXECUTOR --\u003e CONTINUATION\n    EXECUTOR --\u003e REGISTRY\n    \n    %% Core object model connections\n    REGISTRY --\u003e OBJECTS\n    REGISTRY --\u003e GC\n    OBJECTS --\u003e SERIALIZE\n    \n    %% Platform connections\n    EXECUTOR --\u003e MEMORY\n    OBJECTS --\u003e MEMORY\n    SERIALIZE --\u003e PLATFORM\n    \n    %% External dependencies\n    PLATFORM --\u003e BOOST\n    P2P --\u003e RAKNET\n    PLATFORM --\u003e GTEST\n    PLATFORM --\u003e CMAKE\n    \n    %% Styling\n    style USER fill:#e1f5fe\n    style RHO fill:#c8e6c9\n    style PI fill:#ffecb3\n    style TAU fill:#f3e5f5\n    style CONSOLE fill:#fff3e0\n    style EXECUTOR fill:#e8f5e8\n    style REGISTRY fill:#fce4ec\n    style OBJECTS fill:#e0f2f1\n    style GC fill:#f1f8e9\n```\n\n### Key System Components\n\n- **Multi-Language Frontend**: Rho (infix), Pi (stack-based), and Tau (IDL) languages with seamless interoperability\n- **Interactive Console**: Real-time REPL with peer-to-peer networking capabilities  \n- **Distributed Object Model**: Network-transparent objects with type safety across node boundaries\n- **Stack-based Execution**: High-performance virtual machine with continuation support\n- **Incremental Garbage Collection**: Smooth memory management without performance spikes\n- **Code Generation**: Tau IDL generates proxy/agent pairs for network communication\n- **Cross-platform Support**: Unified development experience across major operating systems\n\n## Demo Views\n\n[Pi](Doc/PiTutorial.md) is a postfix language. \n\n![Console](Images/BasicConsole.png)\n\n![Arch](Images/architecture.png)\n\n`Window` illustrates how **Rho** is transpiled to **Pi**. I should make an animated gif of this. But here's a screenshot in the interim. By the way, just using the **Pi* tab is effectively like using the **Console** but has a debugger:\n\n![Window](Images/Window.png)\n\n## Documentation \u0026 Architecture\n\n### **Main Documentation Hub**\n**[Documentation Guide](Doc/Documentation.md)** - Start here for organized navigation of all documentation | **[Doc/ README](Doc/README.md)**\n\n### **System Architecture** \n**[Architecture Resources](resources/README.md)** - Comprehensive system architecture documentation and diagrams\n- **[Overall System Architecture](resources/diagrams/overall-system-architecture.md)** - High-level component relationships and data flow\n- **[Language System Architecture](resources/diagrams/language-system-architecture.md)** - Pi/Rho/Tau translation pipeline and interoperability\n- **[Console Networking Architecture](resources/diagrams/console-networking-architecture.md)** - P2P communication model and protocols\n- **[Build System Architecture](resources/diagrams/build-system-architecture.md)** - CMake structure and dependencies\n- **[Test System Architecture](resources/diagrams/test-system-architecture.md)** - Test infrastructure and validation workflows\n- **[System Overview](resources/architecture/system-overview.md)** - Complete architectural analysis with statistics\n\n### **Development Guides**\n- **Building**: [Build Guide](Doc/OUT_OF_SOURCE_BUILD.md) | [Installation](Doc/Install.md) | [CMake Guide](CMake/README.md)\n- **Languages**: [Pi Tutorial](Doc/PiTutorial.md) | [Rho Tutorial](Doc/RhoTutorial.md) | [Tau Tutorial](Doc/TauTutorial.md) | [Language System](Include/KAI/Language/README.md)\n- **Networking**: [Overview](Doc/Networking.md) | [Architecture](Doc/NetworkArchitecture.md) | [Console Networking](CONSOLE_NETWORKING.md)\n- **Testing**: [Test Guide](Doc/Test.md) | [Connection Testing](Doc/ConnectionTesting.md) | [Test Overview](Test/README.md)\n- **Code Generation**: [Tau Code Generation](Doc/TauCodeGeneration.md) | [Tau Generate](Include/KAI/Language/Tau/Generate/README.md)\n- **Project Status**: [TODO](TODO.md) | [Test Summary](TEST_SUMMARY.md)\n\n### **Component Documentation**\n- **Core System**: [Core README](Include/KAI/Core/README.md) | [Registry](Include/KAI/Core/Object/README.md) | [Config](Include/KAI/Core/Config/README.md)\n- **Executor**: [Executor README](Include/KAI/Executor/README.md) - Virtual machine and execution engine\n- **Console**: [Console README](Include/KAI/Console/README.md) - Interactive shell with networking\n- **Languages**: [Common](Include/KAI/Language/Common/README.md) | [Pi](Include/KAI/Language/Pi/README.md) | [Rho](Include/KAI/Language/Rho/README.md) | [Tau](Include/KAI/Language/Tau/README.md)\n- **Platform Support**: [Platforms](Include/KAI/Platform/README.md) | [Linux](Include/KAI/Platform/Linux/README.md) | [Windows](Include/KAI/Platform/Windows/README.md) | [macOS](Include/KAI/Platform/OSX/README.md)\n\n### **Testing \u0026 Examples**\n- **Test Suites**: [Test Overview](Test/README.md) | [Language Tests](Test/Language/README.md) | [Console Tests](Test/Console/README.md) | [Network Tests](Test/Network/README.md)\n- **Example Code**: [Examples](Examples/README.md) - Sample applications and use cases\n- **Scripts**: [Scripts](Scripts/README.md) - Build and demo scripts\n\n### **External Dependencies**\n- **External Libraries**: [Ext/](Ext/README.md) - Third-party dependencies and libraries\n- **Build System**: [CMake](CMake/README.md) - Build configuration and macros\n\n### **Quick Start Examples**\n\n- Run `./Scripts/run_rho_demo.sh` for a comprehensive demo of Rho language features\n- Run `./Scripts/calc_test.sh` for a demonstration of network calculation\n- Run `./demo_console_communication.sh` for interactive console-to-console networking demo\n- Example scripts in `Test/Language/*/Scripts` directories\n\n## Key Features\n\n- **Zero-Macro Reflection**: Expose C++ types and methods to scripting without macros or source modifications\n- **Distributed Computing**: Share both data and computation across networked nodes\n- **Console Networking**: Real-time console-to-console communication with command sharing\n- **Multiple Languages**: Use Pi (stack-based), Rho (infix), or Tau (IDL) as needed\n- **Type Safety**: Full type checking across network boundaries\n- **Incremental GC**: Smooth, constant-time garbage collection with no spikes\n- **Cross-Platform**: Works on Windows, Linux, macOS, and Unity3D\n- **Network Transparency**: Access remote objects as if they were local\n- **Dynamic Load Balancing**: Automatically distribute workload across network nodes\n\n## Core Components\n\n- **Registry**: Type-safe object factory for creating, managing, and reflecting C++ objects\n- **Domain**: A collection of registries across network nodes\n- **Executor**: Stack-based virtual machine for executing code\n- **Memory Management**: Incremental tri-color garbage collector\n\n### Languages\n\n- **Pi**: Stack-based RPN language inspired by Forth\n- **Rho**: Python-like infix language that compiles to Pi (fully functional with all tests passing)\n- **Tau**: Interface Definition Language (IDL) for network components\n\n### Console Networking\n\nKAI consoles can communicate with each other over the network in real-time:\n\n```bash\n# Console 1 (Server)\n./console\npi\u003e /network start 14600\npi\u003e 2 3 +\n\n# Console 2 (Client)\n./console\npi\u003e /network start 14601\npi\u003e /connect localhost 14600\npi\u003e /@0 10 *              # Multiply Console 1's result by 10\npi\u003e /broadcast stack      # Show stack on all connected consoles\n```\n\n**Network Commands:**\n- `/network start [port]` - Enable networking\n- `/connect \u003chost\u003e \u003cport\u003e` - Connect to peer console\n- `/@\u003cpeer\u003e \u003ccommand\u003e` - Execute command on specific peer\n- `/broadcast \u003ccommand\u003e` - Execute command on all peers\n- `/peers` - List connected consoles\n\nSee [Console Networking Guide](CONSOLE_NETWORKING.md) for complete documentation.\n\n## Example Code\n\nSee [Documentation Guide](Doc/Languages.md).\n\n### Pi (Stack-based)\n\n```pi\n{ dup * } 'square #  // Define a function that squares its input\n5 square @           // Retrieve the function\n\u0026                    // Execute the function\n```\n\n### Rho (Infix)\n\n```rho\nfun square(x) {\n    return x * x\n}\nresult = square(5)  // result is 25\n```\n\n### Distributed Computing\n\n```rho\n// Create a network node\nnode = createNetworkNode()\nnode.listen(14589)\nnode.connect(\"192.168.1.10\", 14589)\n\n// Create data and define a function\ndata = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]\nfun square(x) { return x * x }\n\n// Process the data using distributed execution\nresult = acrossAllNodes(node, data, square)\nprint(result)  // [1, 4, 9, 16, 25, 36, 49, 64, 81, 100]\n```\n\n## Getting Started\n\n### Prerequisites\n\n- Modern C++ compiler (C++23 compatible)\n  - Clang 16+ (default, recommended)\n  - GCC 13+\n  - MSVC 2022+\n- CMake (3.28+)\n- Boost libraries (filesystem, system, program_options, date-time, regex)\n- Ninja (optional but recommended for faster builds)\n\n### Building\n\nClone the repository with submodules:\n```bash\ngit clone https://github.com/cschladetsch/KAI.git\ncd KAI\ngit submodule init\ngit submodule update\n```\n\n#### Using the Build Scripts\n\nBuild scripts that follow best practices for out-of-source builds:\n\n```bash\n# Quick build (using Clang++ by default)\n./b\n\n# Build with GCC\n./b --gcc\n\n# Build without Ninja\n./b --no-ninja\n\n# Using Makefile (Clang++ by default)\nmake\n\n# Using Makefile with GCC\nmake gcc\n\n# Clean build directory\nmake clean\n```\n\n#### Manual Build (Out-of-Source)\n\nFor a manual build, always use the `build/` directory:\n\n```bash\n# Create build directory\nmkdir -p build\ncd build\n\n# Configure with CMake (Clang++ by default)\ncmake ..\n\n# Configure with GCC\ncmake .. -DBUILD_GCC=ON\n\n# Build the project\ncmake --build .   # Cross-platform\n# or\nmake              # Unix systems\n# or\nninja             # If using Ninja generator\n```\n\nFor more detailed build instructions, see [BUILD.md](Doc/BUILD.md).\n\n### Security Configuration\n\nShell operations (backtick syntax) are disabled by default for security. To enable:\n```bash\n# Enable shell syntax during build\ncmake .. -DENABLE_SHELL_SYNTAX=ON\n\n# Or with the build script\n./b --enable-shell\n```\n\n## Applications\n\n### Console\nThe interactive console provides a professional REPL environment with comprehensive features:\n\n```bash\n# Show help and options\n$ ./Console --help\n$ ./Console --version\n\n# Start in different modes\n$ ./Console                    # Interactive Pi mode (default)\n$ ./Console -l rho             # Interactive Rho mode\n$ ./Console script.pi          # Execute Pi script\n$ ./Console -t 2 script.rho    # Execute with trace level 2\n$ ./Console --verbose          # Enable verbose output\n```\n\n**Interactive Session Example:**\n```\n$ ./Console\nKAI Console v0.3.0\nBuilt on Jun 21 2025 at 23:47:34\nType 'help' for available commands.\n\nPi λ help\nKAI Console Help\n\nAvailable help topics:\n  help basics     - Basic usage and commands\n  help history    - History and command expansion\n  help shell      - Shell integration\n  help languages  - Pi and Rho language features\n\nLanguage-specific help:\n  help pi         - Pi language reference\n  help rho        - Rho language reference\n\nBuilt-in Commands:\n  help [topic]    - Show help (optionally for specific topic)\n  clear, cls      - Clear screen\n  exit, quit      - Exit console\n  pi, rho         - Switch language mode\n  history         - Show command history\n  stack           - Show current stack\n  $ \u003ccommand\u003e     - Execute shell command\n\nPi λ 2 3 +\n[0]: 5\n\nPi λ history\nCommand History:\n  1: 2 3 +\n\nPi λ rho\nSwitched to Rho language mode\n\nRho λ x = 42; y = x * 2; y\n[0]: 84\n```\n\n**Professional Features:**\n- **Command-Line Interface**: Full argument parsing with `--help`, `--version`, language selection, trace levels\n- **Interactive Help System**: Context-sensitive help with topics (`help pi`, `help rho`, `help shell`)\n- **Persistent History**: Commands automatically saved to `~/.kai_history` across sessions\n- **Built-in Commands**: `help`, `clear`, `history`, `stack`, `exit`, language switching\n- **Shell Integration**: Execute shell commands with `$ command` (when enabled with ENABLE_SHELL_SYNTAX)\n- **Backtick Expansion**: Embed shell output in expressions: `` `echo 42` 10 + ``\n- **Enhanced Display**: Color-coded stack with orange-colored numbers for better visibility\n- **Error Handling**: User-friendly error messages with suggestions\n- **Auto-installation**: Copies to `~/bin` if directory exists\n\n**Security:**\n- Shell operations disabled by default for safety\n- Enable with `-DENABLE_SHELL_SYNTAX=ON` during build\n\nSee [Console Documentation](Doc/Console.md) for comprehensive usage guide.\n\n### Network Applications\nThe system includes several network applications:\n\n```bash\n# Run a configurable calculation server\n./build/Bin/ConfigurableServer config/server_config.json\n\n# Run a client that sends a calculation request\n./build/Bin/ConfigurableClient config/client_config.json\n```\n\nTry the calculation test demo:\n```bash\n./Scripts/calc_test.sh\n```\n\n### GUI Application\nThe GUI application provides:\n- Syntax highlighted code editing\n- Visual stack inspection\n- Network monitoring\n- Object browser\n- Performance metrics\n\n\n## Project Structure\n\n- **Bin**: Executable output files\n- **build**: Build directory (for all build artifacts)\n- **CMake**: Auxiliary CMake modules\n- **Doc**: Documentation and tutorials\n- **Ext**: External dependencies (git submodules)\n- **Include**: Global include path\n- **Lib**: Library files\n- **Logs**: System logs (ignored by git)\n- **Source**: Project source code\n- **Test**: Unit tests\n\n### Tau Language Module Architecture\n\nThe Tau language module has a well-organized structure for code generation:\n\n#### Code Generation Classes (`Include/KAI/Language/Tau/Generate/`)\n\n- **GenerateProcess**: Base class for all code generators, providing common functionality\n- **GenerateProxy**: Generates client-side proxy classes for remote procedure calls\n- **GenerateAgent**: Generates server-side agent classes for handling incoming requests  \n- **GenerateStruct**: Generates plain data structure definitions\n\nAll generators properly inherit from `GenerateProcess` and have clear separation of concerns:\n\n1. **Proxy Generation** - Creates proxy classes that forward method calls over the network\n2. **Agent Generation** - Creates agent classes that receive and process network requests\n3. **Struct Generation** - Creates plain C++ struct definitions from Tau IDL\n\n#### Source Organization\n\n**Headers** (`Include/KAI/Language/Tau/`):\n- Core components: `Tau.h`, `TauLexer.h`, `TauParser.h`, `TauToken.h`, `TauAstNode.h`\n- Configuration: `Config.h`\n- Code generation: `Generate/` subdirectory\n\n**Implementation** (`Source/Library/Language/Tau/Source/`):\n- `Tau/` - Core language implementation\n- `Generate/` - Code generation implementations\n\n**Tests** (`Test/Language/TestTau/`):\n- Comprehensive test suite including `TauGenerateStructTests.cpp` and `TauSeparateGenerationTests.cpp`\n\nThis architecture enables clean separation between:\n- Interface definitions (Tau IDL)\n- Client-side proxy code (for making remote calls)\n- Server-side agent code (for handling remote calls)\n- Plain data structures (for data transfer objects)\n\n## Platforms\n\n- Windows 10/11 (VS 2017-22)\n- Linux (Ubuntu, Debian)\n- macOS (Sierra and newer)\n- Unity3D (2017+)\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## Complete Project Navigation\n\n### **Architecture \u0026 Design**\n- **[Architecture Overview](resources/README.md)** - Complete system architecture with professional diagrams\n- **[System Diagrams](resources/diagrams/)** - Visual architecture documentation using Mermaid\n- **[System Analysis](resources/architecture/system-overview.md)** - Detailed technical analysis and statistics\n\n### **Core Documentation** (71 README files)\n- **[Main Documentation](Doc/README.md)** - Central documentation hub\n- **[All Documentation Files](Doc/)** - Tutorials, guides, and technical references\n\n### **System Components**\n- **[Core System](Include/KAI/Core/README.md)** - Registry, objects, memory management\n- **[Executor](Include/KAI/Executor/README.md)** - Virtual machine and execution engine  \n- **[Console](Include/KAI/Console/README.md)** - Interactive shell with networking\n- **[Language System](Include/KAI/Language/README.md)** - Pi, Rho, Tau implementation\n- **[Networking](CONSOLE_NETWORKING.md)** - P2P console communication\n\n### **Source Code Structure**\n- **[Include Headers](Include/KAI/README.md)** - All public API headers and interfaces\n- **[Source Code](Source/README.md)** - Implementation files and libraries\n- **[Applications](Source/App/README.md)** - Console, Window, and network applications\n\n### **Testing \u0026 Quality**\n- **[Test Overview](Test/README.md)** - Complete test suite documentation\n- **[Language Tests](Test/Language/README.md)** - Pi, Rho, Tau validation\n- **[Network Tests](Test/Network/README.md)** - P2P communication testing\n- **[Scripts](Scripts/README.md)** - Build, test, and demo scripts\n\n### **Development Tools**\n- **[Build System](CMake/README.md)** - CMake configuration and build tools\n- **[Dependencies](Ext/README.md)** - External libraries and third-party code\n- **[Examples](Examples/README.md)** - Sample code and usage examples\n\n### **Platform Support**\n- **[All Platforms](Include/KAI/Platform/README.md)** - Cross-platform support overview\n- **[Linux](Include/KAI/Platform/Linux/README.md)** - Linux-specific documentation\n- **[Windows](Include/KAI/Platform/Windows/README.md)** - Windows support and configuration\n- **[macOS](Include/KAI/Platform/OSX/README.md)** - macOS development setup\n\n### **Project Statistics**\n- **629** C++ source files\n- **71** README documentation files  \n- **200+** comprehensive test cases\n- **5** complete architecture diagram sets\n- **3** integrated programming languages (Pi/Rho/Tau)\n- **Full** console-to-console networking implementation\n\n**Start exploring**: Begin with the **[Documentation Guide](Doc/Documentation.md)** or dive into **[System Architecture](resources/README.md)** for technical details.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcschladetsch%2Fcppkai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcschladetsch%2Fcppkai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcschladetsch%2Fcppkai/lists"}