ackem  by JasonLiu0826

Local-first AI desktop companion for Windows

Created 2 weeks ago

New!

376 stars

Top 75.3% on SourcePulse

GitHubView on GitHub
Project Summary

Ackem is a local-first AI desktop companion for Windows, designed to provide a private and persistent user experience. It addresses the need for an AI that remembers context, emotions, and relationships without uploading personal data, making it ideal for users who prioritize privacy and a deeply integrated digital assistant.

How It Works

Ackem operates as a Windows desktop application, orchestrating chat, memory, emotion, and relationship state management. It allows users to configure any OpenAI-compatible LLM endpoint, whether cloud-based or local (e.g., Ollama, LM Studio). All personal data, including chats, memories, and settings, is stored locally in a ./data/ directory adjacent to the executable, ensuring data privacy and portability. The architecture is modular, featuring distinct systems for overall orchestration, a "Brain" for memory and understanding, a "Heart" for emotional and relationship state, a "Mouth" for LLM interaction, and a "Neural" layer for embeddings.

Quick Start & Requirements

  • Primary install / run command: Download the release zip, extract it to an SSD path (do not run from within the zip), and launch Ackem.exe or 启动 Ackem.bat.
  • Non-default prerequisites and dependencies: Windows 10/11 64-bit, an LLM API key or local server.
  • Estimated setup time or resource footprint: Approximately 10–30 seconds on first launch for the local embedding model extraction.
  • Links: GitHub Releases, Gitee Releases.

Highlighted Details

  • Local-first architecture ensures all personal data resides on the user's machine.
  • Supports a wide range of OpenAI-compatible LLMs, including DeepSeek, OpenAI, Ollama, and LM Studio.
  • Features structured memory recall, timelines, knowledge graph capabilities, and import of .txt / .md files for long-term context.
  • Companion functionalities include managing trust, mood, relationship stages, personality presets, and optional proactive messages.
  • Offers optional desktop presence features like a system tray icon and an interactive desktop pet (geometric orb with Live2D support).
  • Includes optional capabilities such as voice STT/TTS, a WeChat bridge, and an Extension Center for added functionality.

Maintenance & Community

Ackem is noted as a solo-maintained project currently in active testing, with limited test coverage. Users are encouraged to open issues for any unexpected behavior. No specific community channels (e.g., Discord, Slack) or notable contributor details are provided in the README.

Licensing & Compatibility

The project is licensed under the AGPL-3.0 license. While personal learning, research, and open-source integration are permitted, commercial use, including closed-source products or SaaS offerings, requires a separate commercial license.

Limitations & Caveats

As the project is in active testing and solo-maintained, users may encounter "unexpected behavior or rough edges." While severe issues like frequent crashes are uncommon, imperfections are still possible. Test coverage is limited.

Health Check
Last Commit

1 week ago

Responsiveness

Inactive

Pull Requests (30d)
5
Issues (30d)
8
Star History
379 stars in the last 14 days

Explore Similar Projects

Feedback? Help us improve.