{"id":17526852,"url":"https://github.com/markmbain/aius","last_synced_at":"2025-04-11T00:34:02.986Z","repository":{"id":256067041,"uuid":"834333993","full_name":"markmbain/aius","owner":"markmbain","description":"The best long-term memory for Superagents 🥷and LLMs 🤖. Built with GraphRAG, Knowledge graphs and autonomous ai agents","archived":false,"fork":false,"pushed_at":"2024-09-18T03:43:41.000Z","size":773,"stargazers_count":32,"open_issues_count":0,"forks_count":2,"subscribers_count":5,"default_branch":"main","last_synced_at":"2024-09-18T07:35:05.702Z","etag":null,"topics":["ai-agents","ai-agents-framework","context","embeddings","graphrag","knowledge-base","knowledge-graph","llm","memory","ml","rag"],"latest_commit_sha":null,"homepage":"https://docs.aius.co","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/markmbain.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-27T01:16:35.000Z","updated_at":"2024-09-18T05:42:22.000Z","dependencies_parsed_at":"2025-01-27T00:30:31.317Z","dependency_job_id":null,"html_url":"https://github.com/markmbain/aius","commit_stats":null,"previous_names":["markmbain/aius"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markmbain%2Faius","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markmbain%2Faius/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markmbain%2Faius/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markmbain%2Faius/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/markmbain","download_url":"https://codeload.github.com/markmbain/aius/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248322774,"owners_count":21084336,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","ai-agents-framework","context","embeddings","graphrag","knowledge-base","knowledge-graph","llm","memory","ml","rag"],"created_at":"2024-10-20T15:02:34.123Z","updated_at":"2025-04-11T00:34:02.965Z","avatar_url":"https://github.com/markmbain.png","language":null,"funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"_\u003cp align=\"center\"\u003e\n\t\u003cimg src=\"https://github.com/markmbain/aius/blob/main/assets/images/aius/aius-black.png\" width=\"72px\" alt=\"AIUS Logo\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/badge/License-MIT-green.svg\" alt=\"License: MIT\"\u003e\n\t\u003c/a\u003e\n    \u003ca href=\"https://github.com/markmbain/aius\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/last-commit/markmbain/aius.svg?style=flat\u0026color=blue\" alt=\"GitHub last commit\"/\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/markmbain/aius/releases\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/release/markmbain/aius.svg?style=flat\u0026color=success\" alt=\"Version\"/\u003e\n    \u003c/a\u003e\n\u003c!-- \t\u003ca href=\"https://pypi.python.org/pypi/aius\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/pypi/v/aius.svg?style=flat-square\u0026label=pypi+aius\" alt=\"AIUS memory Python package on PyPi\"\u003e\n\t\u003c/a\u003e --\u003e\n\t\u003ca href=\"https://discord.gg/cM6vFhJbWS\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/discord/1229216579208876242?style=social\u0026logo=discord\" alt=\"AIUS Discord\"\u003e\n\t\u003c/a\u003e\n\t\u003ca href=\"https://x.com/markmbain\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/twitter/follow/markmbain\" alt=\"AIUS Twitter\"\u003e\n\t\u003c/a\u003e\n\u003c/p\u003e\n\n---\n# ● AIUS ●\n⚡ The long-term memory system for your AI, powering ... ⚡ \n\n- 🥷 Superagents and 🤖 AI Agents\n- 🗣️ AI assistants\n- 🧠 LLMs \n\n\u003e Built with GraphRAG, knowledge graphs, autonomous ai agents, latest research and a bit of magic ✨\n\n---\n\n\n# 🌟 Why AIUS - the big cause\nWe aim to __allow AI assistants and Superagents to remember and understand__:\n\n- **You \u0026 Other Humans** - think: Empathetic AI assistants engaged in Conversational AI with you and other individuals they interact with.\n\t- ≠ Not just ≠ limited context-windows, system prompts, pre-trained/fine-tuned knowledge or RAG that doesn't work.\n\t\t- ✔️ **Learning you, from you and for you. Everything on-the-fly.**\n\t\t\t- 🤖 📚 💡 👨 👩\n- **Themselves** - give them: self-consciousness. They'll know why they exist, their values, goals, preferences, memories of past interactions, tools and relationships.\n\t- ≠ Not just ≠ system prompts, prompt-engineered agent definitions with name, role, objectives, and function callings.\n\t\t- ✔️ **Having self-awareness that is: autonomous, dynamic, programmable, adaptable, controllable and safe.**\n\t\t\t- 🥷 🧠 🕰️ 🗣️ 🔒\n- **Content** - envision: Specialized agents being able to remember and understand any content they are exposed to.\n\t- ≠ Not just ≠ static files from private data corpora in limited file formats\n\t\t- ✔️ **Processing multi-modal first-seen content in any format, streamed \u0026 static, in any language they know.**\n\t\t\t-  ➡️ 💬 🎵 🎬 📄 📡\n- **Other agents and assistants** - imagine the AInet - an Internet of Agents, a new ecosystem of AI assistants, AI agents, humans and organizations of these.\n\t- ≠ Not just ≠ pre-trained, piped agents with Human-in-the-loop (HITL)\n\t\t- ✔️ **Building lasting relationships with other assistants, agents, humans and organizations**\n\t\t\t- 🌐 🗣️ 🤖 👥 💻 💼 \n\n\u003e It's a promise that keeps us going 👣 and shipping ⛴️ at a lightning speed ⚡️\n\n---\n\n# 💡 Key features \u0026 design patterns\n- A configurable MemorySystem composed of a MemoryStorage layer, MemoryTypes, and MemoryPods.\n- MemoryPods: configurable Pods that allow setting up separate storage units for different memory types, providing a security isolation layer.\n- Custom MemoryStorages: think KV, Graph, Vector, and other DBMSes under the hood of MemoryPods.\n- MemoryTypes: support for multiple memory types, i.e., episodic memory, entity memory, working memory (WM), short-term (STM), and long-term memory (LTM), etc.\n- Simple high-level ontology:\n    - Beings\n        - Events (relating to energy)\n        - Entities (relating to matter)\n        - Relationships (relating to transformations)\n- A composable system that allows:\n    - Building beings—think agents, assistants, robots—and commissioning them with:\n        - Input interfaces (Sensors)\n        - A memory system\n        - Processing functions\n        - Output interfaces (Tools)\n\n\u003e We start small, ship, listen to feedback, break things, launch and go again.\n\n---\n\n# 🚀 Getting Started\n```bash\n# Install the repository\npip install aius\n```\n\n---\n\n# 🔗 Join the community\n- 🌐 (URL/Web): Visit: https://aius.co\n- 💬 (Discord): Chat: https://discord.gg/cM6vFhJbWS\n- ❌ (X/Twitter): Follow: https://x.com/markmbain\n- 🔗 (LinkedIn): Follow: https://www.linkedin.com/company/aius-ai\n- 🐙 (GitHub): Star \u0026 Fork: https://github.com/markmbain/aius\n- 🐍 (PyPI): Install: https://pypi.org/project/aius/\n\n---\n\n# 🤝 Contribute\n- ⭐️ Star the repo and become one of our [Stargazers](https://github.com/markmbain/aius/stargazers)\n- 💬 [Join our discord](https://discord.gg/cM6vFhJbWS) to chat with the growing community about designs, contribution and use cases\n- Clone: `git clone git@github.com:markmbain/aius.git` and play around\n- 🍴 Fork, develop code, test, document, commit, create pull requests\n- Create [New issues](https://github.com/markmbain/aius/issues/new)\n\n```bash\n# Clone the repo\ngit clone git@github.com:markmbain/aius.git\ncd aius\n\n# Install dependencies\npip install poetry\npoetry install --with dev\n\n```\n\n---\n\n# 📝 License\nMIT License, Copyright (c) 2024 Mark Bain","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarkmbain%2Faius","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarkmbain%2Faius","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarkmbain%2Faius/lists"}