_

---

● 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

• 🌐 (URL/Web): Visit: https://aius.co
• 💬 (Discord): Chat: https://discord.gg/cM6vFhJbWS
• ❌ (X/Twitter): Follow: https://x.com/markmbain
• 🔗 (LinkedIn): Follow: https://www.linkedin.com/company/aius-ai
• 🐙 (GitHub): Star & Fork: https://github.com/markmbain/aius
• 🐍 (PyPI): Install: https://pypi.org/project/aius/

---

🤝 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