Overview
What JuStAI is, what it can do and how the pieces fit. Read the overview
Documentation
Welcome! JuStAI turns cheap network cameras, microphones, speakers and screens into a local AI assistant for every room. Pick the path that fits you.
Find your path
Section titled “Find your path”I want to try itOne command, about 15 minutes, no programming.
What can I ask?Real example conversations to get ideas.
I want to build on itPlugins and changes by vibe coding.
I want to know how it worksArchitecture, technology and decisions.
1. Start here
Section titled “1. Start here”Installation
From an empty Linux PC to your first conversation. Install step by step
2. Set up your home
Section titled “2. Set up your home”Do these once, in this order.
Rooms
Rooms, interaction endpoints and where answers go. Rooms
Cameras and devices
Add cameras, microphones and speakers. Devices
Screens and device app
Use phones, tablets and TVs as screens, microphones and speakers. Displays
Voice and wakeword
Wakeword, echo handling and speaking without a pause. Audio
3. Use it every day
Section titled “3. Use it every day”AI models and languages
Gemini, Ollama, fallback, privacy rules and costs. AI
Seeing and recognising
People, pets, objects and state detectors. Vision
Moving cameras
Pan, tilt, zoom and privacy mode. PTZ
Memory
What the assistant remembers and forgets. Memory
Automations
Do things when something happens. Automations
4. Extend it
Section titled “4. Extend it”Vibe coding
Build JuStAI further with an AI coding assistant. Start
Plugins
Manifest, permissions, sandbox and the SDK. Plugins
5. Run and secure it
Section titled “5. Run and secure it”Deployment
Updates, backups, ports, TLS and local AI with Ollama. Deployment
Security and privacy
What stays at home and how data is protected. Security
6. Under the hood
Section titled “6. Under the hood”Architecture
Containers, modules and data flow. Architecture
Technology stack
Every library and why it was chosen. Tech stack
Development and testing
Set up a dev environment and run the tests. Development · Testing
Decisions (ADR)
Why things are the way they are. ADRs
Need help?
Section titled “Need help?”Questions and ideas go to GitHub Discussions, bugs and feature requests to GitHub Issues.