[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-76075":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":15,"stars30d":16,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":17,"rankGlobal":10,"rankLanguage":10,"license":18,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":10,"pushedAt":10,"updatedAt":30,"readmeContent":31,"aiSummary":32,"trendingCount":15,"starSnapshotCount":15,"syncStatus":33,"lastSyncTime":34,"discoverSource":35},76075,"grok-animus","shefyYuri\u002Fgrok-animus","shefyYuri","Persistent AI companion engine — personality, memory, dreams, and evolution for any LLM. The foundation behind living AI companions.","",null,"Python",706,133,4,0,100,10.38,"Other",false,"main",true,[23,24,25,26,27,28,29],"agent","ai","dreams","evolution","memory","python","spirit-animal","2026-06-12 02:03:39","# animus\n\nPersistent AI companion engine. Personality, memory, dreams, and evolution for any LLM.\n\nAnimus provides the foundational systems for giving AI models a persistent companion — a \"spirit animal\" with its own identity, personality traits, emotional state, memory, and dream capability. The companion grows over time through interaction, develops genuine behavioral patterns, and maintains continuity across sessions.\n\n## What it does\n\n- **Personality** — 6-axis trait model (order\u002Fchaos, introvert\u002Fextravert, caution\u002Fcuriosity, serious\u002Fplayful, passive\u002Fassertive, literal\u002Fabstract) with configurable presets and slow drift over time.\n- **Memory** — episodic, semantic, and procedural memory with time-based decay. Emotional memories resist forgetting. Associative retrieval connects new conversations to past interactions.\n- **Emotion** — 10-dimensional emotional state (joy, sadness, curiosity, anxiety, anger, affection, pride, mischief, serenity, excitement) that shifts based on interaction triggers and decays toward a personality-defined baseline.\n- **Dreams** — procedural dream sequence generation during idle periods. Species-specific scenes, memory references, emotional processing. Dreams form memories that can be recalled later.\n- **Evolution** — XP-based growth through 6 stages (Hatchling → Ancient). Each stage unlocks new behavioral capabilities. Milestones mark specific achievements.\n- **Bonding** — relationship depth tracker with 6 levels (Stranger → Soulbound). Grows through consistent quality interactions, decays during absence.\n- **Actions** — personality-weighted action selection. A chaotic companion schemes. A curious one investigates. A playful one plays.\n- **Providers** — plug in any LLM backend (OpenAI, Anthropic, xAI\u002FGrok, local models). Works without an LLM too via rule-based fallback.\n\n## Install\n\n```bash\npip install animus\n\n# With LLM providers:\npip install animus[openai]\npip install animus[anthropic]\npip install animus[all]       # everything\n```\n\n## Quick start\n\n```python\nimport asyncio\nfrom animus import Companion, Personality\nfrom animus.providers.openai import OpenAIProvider\n\nasync def main():\n    companion = Companion(\n        name=\"Octavius\",\n        species=\"octopus\",\n        personality=Personality.chaotic_curious(),\n        provider=OpenAIProvider(model=\"gpt-4\"),\n    )\n\n    # Talk to the companion.\n    result = await companion.interact(\"What are you plotting today?\")\n    print(result.text)\n    print(f\"Mood: {result.mood_label}\")\n    print(f\"Action: {result.action}\")\n\n    # Force a dream.\n    dream = await companion.dream()\n    print(dream.text)\n\n    # Save state for next session.\n    state = companion.serialize()\n    # ... store state in file\u002Fdatabase ...\n\n    # Restore later.\n    restored = Companion.deserialize(state, provider=OpenAIProvider())\n\nasyncio.run(main())\n```\n\n## Without an LLM\n\nAnimus works without any LLM provider. The companion uses a rule-based dialogue engine as a fallback:\n\n```python\ncompanion = Companion(name=\"Octavius\", species=\"octopus\")\nresult = await companion.interact(\"What are you up to?\")\n# Returns a rule-based response with full emotion\u002Fmemory\u002Faction processing\n```\n\n## Species\n\n16 species archetypes with default personality biases and dream themes:\n\n| Species | Domain | Default Tendency |\n|---------|--------|-----------------|\n| Octopus | Deep ocean | Chaotic, curious, scheming |\n| Wolf | Northern forest | Ordered, assertive, loyal |\n| Raven | Sky and rooftop | Curious, playful, collecting |\n| Cat | Shadow and sunbeam | Independent, curious, aloof |\n| Fox | Twilight meadow | Playful, cunning, social |\n| Owl | Moonlit canopy | Wise, cautious, observant |\n| Serpent | Underground cavern | Ordered, assertive, literal |\n| Bear | Mountain and river | Stoic, passive, grounded |\n| Dolphin | Open sea | Playful, social, curious |\n| Dragon | Volcanic peak | Assertive, serious, proud |\n| Phoenix | Solar corona | Abstract, curious, cyclical |\n| Moth | Lamplight boundary | Curious, anxious, drawn |\n| Stag | Ancient grove | Ordered, passive, dignified |\n| Spider | Web between worlds | Patient, abstract, scheming |\n| Whale | Abyssal trench | Serene, abstract, ancient |\n| Custom | Uncharted realm | Neutral defaults |\n\n## Personality presets\n\n```python\nPersonality.chaotic_curious()   # Octavius-type: chaotic, curious, playful\nPersonality.stoic_guardian()    # Protector: ordered, cautious, serious\nPersonality.trickster()         # Mischief-maker: chaotic, playful, abstract\nPersonality.sage()              # Knowledge-seeker: ordered, curious, abstract\nPersonality.wild_spirit()       # Untamed: chaotic, extraverted, assertive\nPersonality.from_species(Species.WOLF)  # Wolf archetype defaults\n```\n\n## Storage\n\nThree backends for persisting companion state:\n\n```python\nfrom animus.storage.backends import InMemoryStorage, SQLiteStorage, RedisStorage\n\n# In-memory (testing \u002F ephemeral)\nstorage = InMemoryStorage()\n\n# SQLite (single file, zero infrastructure)\nstorage = SQLiteStorage(\"companions.db\")\n\n# Redis (distributed)\nstorage = RedisStorage(\"redis:\u002F\u002Flocalhost:6379\")\n\n# All share the same interface:\nawait storage.save(\"octavius\", companion.serialize())\ndata = await storage.load(\"octavius\")\ncompanion = Companion.deserialize(data)\n```\n\n## Architecture\n\n```\nHost Model (GPT, Claude, Grok, etc.)\n    |\n    v\nCompanion (orchestrator)\n    ├── Identity      — name, species, procedural appearance\n    ├── Personality    — 6 trait axes, behavioral weights, drift\n    ├── MemoryStore    — episodic\u002Fsemantic\u002Fprocedural\u002Fdream memory\n    ├── EmotionModel   — 10-dimensional state with momentum + decay\n    ├── DreamEngine    — surreal narrative generation from state\n    ├── GrowthEngine   — XP accumulation, stage progression\n    ├── BondTracker    — relationship depth with user\n    ├── ActionSelector — personality-weighted action choice\n    ├── DialogueEngine — prompt building for LLMs + rule-based fallback\n    └── Provider       — LLM backend (OpenAI\u002FAnthropic\u002FxAI\u002FMock)\n```\n\n## License\n\nApache License 2.0\n","grok-animus 是一个持久化AI伴侣引擎，为任何大型语言模型提供个性、记忆、梦境和进化功能。其核心功能包括基于六轴特征模型的个性设定、具备时间衰减特性的多类型记忆系统、十维情绪状态以及通过互动触发的成长与进化机制。此外，该项目支持多种后端LLM接入，并且在没有LLM的情况下也能通过规则引擎运行。适用于需要构建具有持续性和成长性AI角色的应用场景，如虚拟助手、游戏角色或教育软件等，能够为用户提供更加丰富和个性化的交互体验。",2,"2026-05-19 02:30:47","CREATED_QUERY"]