Visão geral
Toposync é um projeto open source, local-first, para Spatial Home Automation com inteligência local. Ele conecta câmeras, áreas, dispositivos, eventos, automações e contexto do Home Assistant em uma visualização 2D e 3D interpretável de um ambiente residencial privado.
Esta documentação é primeiro prática. Comece aqui para entender a forma do projeto, depois siga para instalação, primeiro uso, câmeras, Home Assistant OS ou desenvolvimento.
O que o Toposync tenta fazer
O Toposync adiciona contexto espacial à automação residencial. Em vez de tratar câmeras, entidades, áreas e automações como listas desconectadas, ele dá a elas um modelo compartilhado da casa.
Isso permite perguntar:
- onde algo aconteceu?
- qual câmera viu?
- qual área mapeada foi afetada?
- quais dispositivos ou automações próximos estão relacionados?
- o que deve ser armazenado, exibido ou enviado como notificação?
A linguagem de produto para isso é Spatial Home Automation, apoiada por Spatial Camera Mapping, Spatial Events, Spatial Intelligence e Spatial Awareness.
Estado atual
Toposync está em alpha early access. Ele está pronto para testes cuidadosos por usuários técnicos, não para operação diária crítica.
Use ambientes de teste contidos, entidades não críticas do Home Assistant, redes privadas, logs sanitizados e planos de rollback. Ainda não dependa do Toposync para monitoramento de segurança sem supervisão, fluxos de emergência, controle de acesso ou automações em que falha possa causar dano.
Leia Alpha testing antes de conectar câmeras ou automações importantes.
Comece pelo objetivo
| Objetivo | Comece aqui |
|---|---|
| Entender o produto | O que é o Toposync |
| Entender a linguagem de categoria | Conceitos espaciais |
| Entender o comportamento local-first | Local-first |
| Instalar o Toposync | Escolha sua instalação |
| Criar o primeiro mapa | Crie sua primeira composição |
| Adicionar câmeras | Adicione sua primeira câmera |
| Calibrar o espaço da câmera | Mapeamento de câmeras |
| Criar fluxos de evento | Crie seus primeiros pipelines |
| Usar Home Assistant OS | Add-on para Home Assistant OS |
| Desenvolver ou estender o Toposync | Arquitetura |
Caminhos de instalação
Os principais caminhos de instalação são:
- add-on para Home Assistant OS em ambientes Home Assistant supervisionados;
- Python com
uvpara instalações diretas em Linux, macOS e Windows; - Docker CPU para servidores locais e homelabs;
- Docker CUDA ou bundles de upgrade para hosts de processamento com GPU;
- processing servers quando cargas de câmera ou visão devem rodar em outra máquina.
Use Escolha sua instalação para escolher o caminho certo antes de instalar.