Kataglyphis-Inference-Engine
An inference engine with Flutter/Dart frontend and Rust/C++ backend, showcasing Gstreamer capabilities enhanced with AI. Read further if you are interested in cross platform AI inference.
Overview
Kataglyphis-Inference-Engine bundles a Flutter/Dart frontend, a Rust/C++ inference core, and a rich set of camera streaming pipelines powered by GStreamer. The repository acts as an end-to-end reference for building cross-platform inference products that target desktop, web, and embedded devices.
Highlights & Key Features โ Kataglyphis-Inference-Engine
๐ Highlights
- ๐จ GStreamer native GTK integration โ Leveraging users to write beautiful Linux AI inference apps.
- ๐น GStreamer WebRTC livestreaming with ready-to-use pipelines for USB, Raspberry Pi, and Orange Pi cameras.
- ๐ flutter_rust_bridge integration โ Ensures a seamless API boundary between Dart UI and Rust logic.
- ๐ณ Containerized development flow plus native instructions for Windows, Linux, web. For details in my build environment look into Kataglyphis-ContainerHub
- ๐ Python inference demos for rapid experimentation alongside the Rust core.
๐ Feature Status Matrix
Core Features
| Category | Feature | Win x64 | Linux x64 | Linux ARM64 | Linux RISC-V | Android |
|---|---|---|---|---|---|---|
| Camera Streaming | ๐น GStreamer WebRTC Livestream | โ๏ธ | โ๏ธ | โ๏ธ | โ๏ธ | N/A |
| Supported Cameras | ๐ USB Devices | โ๏ธ | โ๏ธ | โ๏ธ | โ๏ธ | N/A |
| ๐ Raspberry Pi Camera | N/A | โ๏ธ | โ๏ธ | โ๏ธ | N/A | |
| ๐ Orange Pi Camera | N/A | โ | โ | โ | N/A | |
| ๐ฑ Native Camera API | N/A | N/A | N/A | N/A | โ๏ธ |
Infrastructure & Build
| Category | Feature | Win x64 | Linux x64 | Linux ARM64 | Linux RISC-V | Android |
|---|---|---|---|---|---|---|
| Containerization | ๐ณ Dockerfile | โ๏ธ | โ๏ธ | โ๏ธ | โ๏ธ | N/A |
| ๐ณ Docker Compose | N/A | โ๏ธ | โ๏ธ | โ๏ธ | N/A | |
| Native Integration | ๐จ GTK Integration | N/A | โ๏ธ | โ๏ธ | โ๏ธ | N/A |
| ๐ช Win32 API | โ๏ธ | N/A | N/A | N/A | N/A | |
| ๐ค Android NDK | N/A | N/A | N/A | N/A | โ๏ธ | |
| Bridge Layer | ๐ flutter_rust_bridge | โ๏ธ | โ๏ธ | โ๏ธ | โ๏ธ | โ๏ธ |
| Compiler | ๐ง Clang-CL | โ๏ธ | N/A | N/A | N/A | N/A |
| ๐ง GCC/Clang | N/A | โ๏ธ | โ๏ธ | โ๏ธ | โ๏ธ |
Testing & Quality Assurance
| Category | Feature | Win x64 | Linux x64 | Linux ARM64 | Linux RISC-V | Android |
|---|---|---|---|---|---|---|
| Unit Testing | ๐งช Advanced unit testing | ๐ถ | ๐ถ | ๐ถ | ๐ถ | ๐ถ |
| Performance | โก Advanced performance testing | ๐ถ | ๐ถ | ๐ถ | ๐ถ | ๐ถ |
| Security | ๐ Advanced fuzz testing | ๐ถ | ๐ถ | ๐ถ | ๐ถ | ๐ถ |
Frontend Platforms
| Category | Feature | Win x64 | Linux x64 | Linux ARM64 | Linux RISC-V | Android |
|---|---|---|---|---|---|---|
| Flutter UI | ๐ฆ Flutter Web Support | โ๏ธ | โ๏ธ | โ๏ธ | โ๏ธ | โ๏ธ |
| ๐ป Flutter Desktop | โ๏ธ | โ๏ธ | โ๏ธ | โ๏ธ | N/A | |
| ๐ฑ Flutter Mobile | N/A | N/A | N/A | N/A | โ๏ธ |
Platform Summary
| Platform | Architecture | Status | Notes |
|---|---|---|---|
| ๐ช Windows | x86-64 | โ๏ธ | Built with clang-cl, Win32 integration |
| ๐ง Linux | x86-64 | โ๏ธ | Full GTK support, Docker ready |
| ๐ง Linux | ARM64 | โ๏ธ | SBC optimized (RPi, OPi support) |
| ๐ง Linux | RISC-V | โ๏ธ | Emerging architecture support |
| ๐ค Android | ARM64/x86-64 | โ๏ธ | Native camera, NDK integration |
Legend:
- โ๏ธ Completed - Feature fully implemented and tested
- ๐ถ In Progress - Active development underway
- โ Not Started - Planned but not yet begun
- N/A - Not applicable for this platform
Quick Start
- Clone the repository with submodules:
NOTE: On Windows I use Git Bash instead of
Powershell or cmd
git clone --recurse-submodules --branch develop git@github.com:Kataglyphis/Kataglyphis-Inference-Engine.git
cd Kataglyphis-Inference-Engine
- Initialize submodules if needed.
If u used--recurse-submoduleswhile cloning you are already good.
Otherwise you can use this :smile:git submodule update --init --recursive
Refer to the detailed docs below for platform-specific requirements, camera streaming pipelines, and deployment workflows.
Documentation
| Topic | Location | Description |
|---|---|---|
| Getting Started | docs/source/getting-started.md | Environment prerequisites, installation, and run commands. |
| Platform Guides | docs/source/platforms.md | Container, Windows, Raspberry Pi, and web build instructions. |
| Camera Streaming | docs/source/camera-streaming.md | GStreamer WebRTC pipelines and Python inference demos. |
| Upgrade guide | docs/source/upgrade-guide.md | How to keep things up-to-date. |
Build the full Sphinx documentation from the docs/ directory when you need a browsable site.
Tests
Testing infrastructure is under active development. Track progress on the roadmap or contribute test plans via pull requests.
Roadmap
Upcoming features and improvements will be documented in this repository.
Please have a look docs/source/roadmap.md for more deetails.
Contributing
Contributions are what make the open-source community amazing. Any contributions are greatly appreciated.
- Fork the project.
- Create your feature branch (
git checkout -b feature/AmazingFeature). - Commit your changes (
git commit -m 'Add some AmazingFeature'). - Push to the branch (
git push origin feature/AmazingFeature). - Open a Pull Request.
License
MIT (see here)
Acknowledgements
Thanks to the open-source community and all contributors!
Literature
Helpful tutorials, documentation, and resources:
Multimedia
Rust
Raspberry Pi
CMake/C++
Flutter/Dart
Protocols
Tooling
Android
Contact
Jonas Heinle
Twitter: @Cataglyphis_
Email: cataglyphis@jonasheinle.de
Project Links:
- GitHub: Kataglyphis-Inference-Engine
- Homepage: Official Site
Libraries
- blog_dependent_app_attributes
- blog_page_config
- js/gstwebrtc_api_interop
- l10n/app_localizations
- l10n/app_localizations_de
- l10n/app_localizations_en
- main
- my_two_cents_config
- Pages/AboutMePage/about_me_page
- Pages/AboutMePage/Widgets/about_me_table
- Pages/AboutMePage/Widgets/donation
- Pages/AboutMePage/Widgets/perfect_day_chart
- Pages/AboutMePage/Widgets/skill_table
- Pages/Blog/blog_page
- Pages/blog_dependent_screen_configurations
- Pages/DataPage/BlockOverviewPage/block_entry
- Pages/DataPage/BlockOverviewPage/block_entry_list
- Pages/DataPage/BlockOverviewPage/block_overview_page
- Pages/DataPage/BlockOverviewPage/block_overview_page_config
- Pages/DataPage/media_critics_page
- Pages/ErrorPage/error_page
- Pages/ErrorPage/error_page_stateful_branch_info_provider
- Pages/ErrorPage/error_page_widget
- Pages/Footer/Pages/configs/privacy_policy_config
- Pages/Home/home_config
- Pages/jotrockenmitlocken_screen_configurations
- Pages/LandingPage/landing_page
- Pages/StreamPage/stream_page
- Pages/StreamPage/webrtc_view
- Pages/StreamPage/webrtc_view_stub
- Routing/jotrockenmitlocken_router
- Widgets/Navigation/old/Navbar/mobile/drawer_item