Anima is an open-source Agent OS designed to imbue existing hardware with perceptive, decision-making, and learning AI capabilities. It transforms passive "connected devices" into collaborative intelligent agents, enabling them to understand their environment, users, and each other. Targeted at users and developers seeking to unlock advanced AI functionality in their smart home devices, Anima offers a path to more autonomous and context-aware hardware.

How It Works

Anima operates as a local network runtime, discovering and managing hardware via Adapters. Its core is a LangGraph-based LLM Brain that synthesizes device state, environmental signals, user intent, and long-term Memory to generate intelligent action plans. Domain-specific knowledge and decision logic are encapsulated in Skills, allowing for context-aware operations beyond simple commands. A layered Memory system facilitates incremental learning of user habits and preferences over time, enhancing proactive and personalized automation.

Quick Start & Requirements

• Install/Run: Clone the repository, then run pnpm install followed by pnpm dev.
• Prerequisites: Node.js (>=18), pnpm (>=8), Python (>=3.11), and uv. Specific MIoT dependencies require uv sync --extra dev --extra miot --python 3.13.
• Access: Dashboard at http://localhost:3000, API docs at http://localhost:8080/docs.
• Xiaomi Integration: QR login via the Dashboard is the recommended method.

Highlighted Details

• Zero-Config Discovery: Automatically discovers and integrates devices on the local network.
• AI Skills: Encapsulates device-specific domain knowledge, including comfort models and cross-device coordination.
• Memory System: Supports long-term learning of user habits and preferences through a layered file-based approach.
• LLM Brain: Utilizes OpenAI-compatible LLMs for planning, operating within defined Skill boundaries.
• Extensible Skills: Allows users to define new device behaviors or home workflows.
• Local-First: Core runtime operates locally, prioritizing local network control.

Maintenance & Community

Contributions are welcomed, with guidelines available in CONTRIBUTING.md and ARCHITECTURE_GUARDRAILS.md. Specific community channels (e.g., Discord, Slack) or notable contributors are not detailed in the provided README.

Licensing & Compatibility

Licensed under the Apache License 2.0, permitting broad use, modification, and distribution, including within commercial and closed-source applications.

Limitations & Caveats

Anima is described as an "early-stage" project with several evolving areas, including adapter support, advanced memory retrieval, multi-user capabilities, and deployment strategies. Local control for MIoT devices relies on the device's network availability and token. Security recommendations advise against public exposure of the API/Dashboard and emphasize careful automation configuration.