momori777/Artemis

What it solves

Artemis is a fully local, uncensored AI companion system designed to provide a private and customizable experience without relying on cloud APIs or subscriptions. It integrates multiple AI modalities—text, voice, and visuals—into a single interface to create immersive, character-driven interactions that remain entirely on the user's machine.

How it works

The project orchestrates several open-source tools to create a cohesive experience:

• LLM Engine: Uses llama.cpp to run large language models (like Qwen MoE models) locally for chat and reasoning.
• Voice & Speech: Employs GPT-SoVITS for high-quality text-to-speech (TTS) and Faster-Whisper for automatic speech recognition (ASR).
• Visuals: Integrates ComfyUI for AI image generation and Live2D for real-time character animations and expressions.
• Memory System: Combines mem0 (using a Qdrant vector database) and headroom for long-term memory, utilizing hybrid search (Vector + BM25) and a background worker to consolidate facts.
• Behavior Engine: A layered decision system that tracks relationship scores (interest, trust, attraction, etc.), relationship stages, and simulated hormonal cycles to dynamically adjust the AI's tone and behavior.
• Interfaces: Provides a web chat frontend, as well as integration with QQ and Telegram bots and a PySide6-based desktop pet.

Who it’s for

Users who want a highly private, uncensored AI companion with deep character customization and the ability to run everything locally on their own hardware (specifically NVIDIA GPUs).

Highlights

• Multi-Character Hot-Swap: Instantly switch between different AI personas with isolated memories and automatically updated TTS weights and Live2D models.
• SillyTavern Integration: Supports importing character cards (PNG/JSON) and conversation logs from SillyTavern.
• Smart VRAM Tiering: Automatically detects GPU VRAM to optimize model loading strategies (e.g., keeping all models online vs. hot-swapping for 8GB cards).
• Complex Relationship Simulation: A behavior engine that manages mood swings, conflict levels, and relationship progression from first meeting to long-term dating.
• Local Creative Suite: Includes the "Artemis Studio" console for independent TTS and image generation regardless of the LLM status.