imagine
Version, currently master branch1 version
- master branchlatestAug 30, 2023
github.com/stakach/imagine
a crystal lang AI video toolkit
Installation
# Add this to your shard.yml
dependencies:
imagine:
github: stakach/imagine
branch: mastermaster is a branch, not a release, so this tracks it rather than pinning a version.
Then run:
shards installshard.yml
- Crystal
- no constraint declared
Dependencies
Runtime Dependencies
- v4l2*github: spider-gazelle/v4l2.cr
- ffmpeg*github: spider-gazelle/ffmpeg
- tflite_image*github: spider-gazelle/tflite_image
Development Dependencies
- ameba*github: veelenga/amebadev
README
Imagine, an AI video monitoring framework
Imagine is a crystal lang web platform for AI processing and monitoring video streams.
- takes UDP H.264 video streams as input (needs to be web compatible format)
- runs frames through TensorFlow Lite models
- outputs detection data to a websocket and optionally a Redis channel or webhook
- detection coordinates only
- optionally the PNG image (websocket and webhook)
- optionally the PNG image with markup applied (websocket and webhook)
- grabs segments from the video stream and makes it available as MPEG-DASH for browser viewing
- this will be pushed to a local volume for serving
- and optionally can be pushed to a S3 for serving video at scale
This is intended to run independently of any applications that make use of the output. KISS
Documentation
Use the provided docker-compose to launch the application.
It's not intended to be public facing as it will not scale (without wasting a lot processing power) but is designed so that it can be used in scalable applications. Obviously works fine as a frontend for your personal Raspberry Pi projects.
Pre-prepared TF Lite models
These are a bunch of models available that will work with Coral Edge TPUs and the example object detection model
- https://github.com/google-coral/test_data
Converting TF Models for use
- List of pre-built detection models
- guide for converting these models to run on TF Lite
- Download the tooling:
pip3 install tf-models-official pip install tensorflow-object-detection-api
- Download the tooling:
Documentation
Built from the current release. The first visit to a release nobody has asked for starts its build.
Links
This branch
- Branch
master- Seen
- Aug 30, 2023
- Indexed
- yes
Dependents
Repository
github.com/stakach/imagine
Metadata
- Created
- Aug 12, 2026
- Updated
- Aug 15, 2026
- Synced
- Aug 15, 2026
- Versions
- 1