/aius

The long-term memory for your Superagents πŸ₯·and LLMs πŸ€–. Built with GraphRAG, Knowledge graphs and autonomous ai agents

Primary LanguagePythonMIT LicenseMIT

_

AIUS Logo

License: MIT GitHub last commit Version AIUS Discord AIUS Twitter


● AIUS ●

⚑ The long-term memory system for your AI, powering ... ⚑

  • πŸ₯· Superagents and πŸ€– AI Agents
  • πŸ—£οΈ AI assistants
  • 🧠 LLMs

Built with GraphRAG, knowledge graphs, autonomous ai agents, latest research and a bit of magic ✨


🌟 Why AIUS - the big cause

We aim to allow AI assistants and Superagents to remember and understand:

  • You & Other Humans - think: Empathetic AI assistants engaged in Conversational AI with you and other individuals they interact with.
    • β‰  Not just β‰  limited context-windows, system prompts, pre-trained/fine-tuned knowledge or RAG that doesn't work.
      • βœ”οΈ Learning you, from you and for you. Everything on-the-fly.
        • πŸ€– πŸ“š πŸ’‘ πŸ‘¨ πŸ‘©
  • Themselves - give them: self-consciousness. They'll know why they exist, their values, goals, preferences, memories of past interactions, tools and relationships.
    • β‰  Not just β‰  system prompts, prompt-engineered agent definitions with name, role, objectives, and function callings.
      • βœ”οΈ Having self-awareness that is: autonomous, dynamic, programmable, adaptable, controllable and safe.
        • πŸ₯· 🧠 πŸ•°οΈ πŸ—£οΈ πŸ”’
  • Content - envision: Specialized agents being able to remember and understand any content they are exposed to.
    • β‰  Not just β‰  static files from private data corpora in limited file formats
      • βœ”οΈ Processing multi-modal first-seen content in any format, streamed & static, in any language they know.
        • ➑️ πŸ’¬ 🎡 🎬 πŸ“„ πŸ“‘
  • Other agents and assistants - imagine the AInet - an Internet of Agents, a new ecosystem of AI assistants, AI agents, humans and organizations of these.
    • β‰  Not just β‰  pre-trained, piped agents with Human-in-the-loop (HITL)
      • βœ”οΈ Building lasting relationships with other assistants, agents, humans and organizations
        • 🌐 πŸ—£οΈ πŸ€– πŸ‘₯ πŸ’» πŸ’Ό

It's a promise that keeps us going πŸ‘£ and shipping ⛴️ at a lightning speed ⚑️


πŸ’‘ Key features & design patterns

  • A configurable MemorySystem composed of a MemoryStorage layer, MemoryTypes, and MemoryPods.
  • MemoryPods: configurable Pods that allow setting up separate storage units for different memory types, providing a security isolation layer.
  • Custom MemoryStorages: think KV, Graph, Vector, and other DBMSes under the hood of MemoryPods.
  • MemoryTypes: support for multiple memory types, i.e., episodic memory, entity memory, working memory (WM), short-term (STM), and long-term memory (LTM), etc.
  • Simple high-level ontology:
    • Beings
      • Events (relating to energy)
      • Entities (relating to matter)
      • Relationships (relating to transformations)
  • A composable system that allows:
    • Building beingsβ€”think agents, assistants, robotsβ€”and commissioning them with:
      • Input interfaces (Sensors)
      • A memory system
      • Processing functions
      • Output interfaces (Tools)

We start small, ship, listen to feedback, break things, launch and go again.


πŸš€ Getting Started

# Install the repository
pip install aius

πŸ”— Join the community


🀝 Contribute

  • ⭐️ Star the repo and become one of our Stargazers
  • πŸ’¬ Join our discord to chat with the growing community about designs, contribution and use cases
  • Clone: git clone git@github.com:markmbain/aius.git and play around
  • 🍴 Fork, develop code, test, document, commit, create pull requests
  • Create New issues
# Clone the repo
git clone git@github.com:markmbain/aius.git
cd aius

# Install dependencies
pip install poetry
poetry install --with dev

πŸ“ License

MIT License, Copyright (c) 2024 Mark Bain