logo

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.

Build + run + test on Linux natively Windows CMake (clang-cl) natively Build + test + run for web
Build + test + run android appAutomatic Dependency Submission CodeQL
Dependabot Updates TopLang Donate Twitter YouTube

Official homepage

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

  1. 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
  1. Initialize submodules if needed.
    If u used --recurse-submodules while 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.

  1. Fork the project.
  2. Create your feature branch (git checkout -b feature/AmazingFeature).
  3. Commit your changes (git commit -m 'Add some AmazingFeature').
  4. Push to the branch (git push origin feature/AmazingFeature).
  5. 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:

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/about_me_page_navbar_config
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/LandingPage/landing_page_navbar_page_config
Pages/StreamPage/stream_page
Pages/StreamPage/stream_page_navbar_config
Pages/StreamPage/webrtc_view
Pages/StreamPage/webrtc_view_stub
Routing/jotrockenmitlocken_router
Widgets/Navigation/old/Navbar/mobile/drawer_item