Engineering notes / Decisions
Decisions that make the system easier to reason about.
Home AI evolves with my needs. These integration and operational decisions have the greatest impact on how the project works day to day.
Existing components, custom integration.
Open WebUI provides the chat interface, Qdrant stores vectors and Docker runs some of the services. My code connects these components to tools and documentation. This lets me develop the features I need without rebuilding the entire stack.
Documentation and memory have different jobs.
I read the current configuration from a maintained document. Earlier decisions and technical references are retrieved from separate collections. The agent can choose a source for the question, without automatically treating historical information as current state.
Task state is part of the system.
A longer operation may finish after an HTTP response or span several conversation turns. Tools expose task status and results, while Autopilot maintains its own execution history. This helps distinguish starting an operation from completing it.
Restarting a process and preserving data are separate decisions.
A process can be restarted, but its state needs a known home. Autopilot and the GPU controller use persistent volumes. During migrations I preserve data and a rollback path. A process health check does not replace checking the task result.
An uncertain outcome needs checking.
A dropped connection does not tell me whether a remote operation completed. Error handling preserves that uncertainty. Before retrying, I check the device state or the previous task result.
I test a defined scope.
The project includes tests for argument validation, task memory, integrations and error handling. I also run checks through live services. Results apply to a specific scenario and version; a few successful tasks do not establish universal agent reliability.
The public site is a separate release.
The site presents architecture and examples. Code being prepared for release will have its own demo configuration. The aim is a description and package that can be understood without access to my private installation.