Summary

Agentic-Desktop-Pet offers a next-generation AI desktop companion, merging LLMs with persistent knowledge graph memory, dynamic emotions, RPG elements, and personal assistant capabilities. It targets users seeking intelligent virtual entities and developers building advanced AI applications, providing an interactive, evolving companion with practical utility.

How It Works

A Python FastAPI backend integrates core logic with a Godot 4.x frontend. The backend features a Cognee knowledge graph memory system for semantic/graph retrieval and persistence, a dynamic emotion engine influencing behavior, and an RPG system for character progression. A toolset enables file operations, code execution, task management, and system commands, mimicking personal assistant functions.

Quick Start & Requirements

• Primary Install/Run: Backend: cd backend && uv sync && uv run main.py. Frontend: Open godot/ in Godot 4.3+ and run.
• Prerequisites: Python 3.13+, Godot 4.3+, LLM API Key (configure in .env).
• Links: No external docs. Theme files (.pck) require placement in themes/.

Highlighted Details

• Cognee Memory: Advanced knowledge graph memory with semantic/graph retrieval and persistence.
• Assistant Functions: File operations, code execution, task management, system commands.
• Dynamic Systems: Evolving emotions and RPG mechanics (attributes, XP, skills) shape agent behavior.
• Moddable Themes: Supports easy switching of visual themes.

Maintenance & Community

Development is ongoing with "many bugs." Updates are sporadic ("when I have time"). Contributions are welcome. Roadmap referenced via TODO.md; no community channels listed.

Licensing & Compatibility

Code snippets are usable, but the entire project cannot be commercially repackaged. Asset copyrights must be verified. This is a custom license with commercial restrictions.

Limitations & Caveats

The project is in early development with known bugs. Commercial repackaging is disallowed, and asset copyrights require user attention.