mem0ai-101deploy


Namemem0ai-101deploy JSON
Version 0.0.13a0 PyPI version JSON
download
home_pageNone
SummaryLong-term memory for AI Agents
upload_time2024-08-05 10:44:13
maintainerNone
docs_urlNone
authorMem0
requires_python<4.0,>=3.8
licenseNone
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <p align="center">
  <img src="docs/images/banner.png" width="800px" alt="Mem0 Logo">
</p>

<p align="center">
  <a href="https://mem0.ai/slack">
    <img src="https://img.shields.io/badge/slack-mem0-brightgreen.svg?logo=slack" alt="Mem0 Slack">
  </a>
  <a href="https://mem0.ai/discord">
    <img src="https://dcbadge.vercel.app/api/server/6PzXDgEjG5?style=flat" alt="Mem0 Discord">
  </a>
  <a href="https://x.com/mem0ai">
    <img src="https://img.shields.io/twitter/follow/mem0ai" alt="Mem0 Twitter">
  </a>
  <a href="https://www.ycombinator.com/companies/mem0"><img src="https://img.shields.io/badge/Y%20Combinator-S24-orange?style=flat-square" alt="Y Combinator S24"></a>
  <a href="https://www.npmjs.com/package/mem0ai"><img src="https://img.shields.io/npm/v/mem0ai?style=flat-square&label=npm+mem0ai" alt="mem0ai npm package"></a>
  <a href="https://pypi.python.org/pypi/mem0ai"><img src="https://img.shields.io/pypi/v/mem0ai.svg?style=flat-square&label=pypi+mem0ai" alt="mem0ai Python package on PyPi"></a>
  <a href="https://mem0.ai/email"><img src="https://img.shields.io/badge/substack-mem0-brightgreen.svg?logo=substack&label=mem0+substack" alt="Mem0 newsletter"></a>
</p>

# Mem0: The Memory Layer for Personalized AI

Mem0 provides an intelligent, adaptive memory layer for Large Language Models (LLMs), enhancing personalized AI experiences by retaining and utilizing contextual information across diverse applications. This enhanced memory capability is crucial for applications ranging from customer support and healthcare diagnostics to autonomous systems and personalized content recommendations, allowing AI to remember user preferences, adapt to individual needs, and continuously improve over time.

## πŸš€ Quickstart

### Installation

The Mem0 package can be installed directly from pip command in the terminal.

```bash
pip install mem0ai
```

### Basic Usage (Open Source)

Mem0 supports various LLMs, details of which can be found in our docs, checkout [Supported LLMs](https://docs.mem0.ai/llms). By default, Mem0 is equipped with ```gpt-4o```, and to use it, you need to set the keys in the environment variable.

```python
import os
os.environ["OPENAI_API_KEY"] = "sk-xxx"
```

Now, you can simply initialize the memory.

```python
from mem0 import Memory

m = Memory()
```

You can perform the following task on the memory.
1. Add: adds memory
2. Update: update memory of a given memory_id
3. Search: fetch memories based on a query
4. Get: return memories for a certain user/agent/session
5. History: describes how a memory has changed over time for a specific memory ID

```python
# 1. Add: Store a memory from any unstructured text
result = m.add("I am working on improving my tennis skills. Suggest some online courses.", user_id="alice", metadata={"category": "hobbies"})

# Created memory --> 'Improving her tennis skills.' and 'Looking for online suggestions.'
```

```python
# 2. Update: update the memory
result = m.update(memory_id=<memory_id_1>, data="Likes to play tennis on weekends")

# Updated memory --> 'Likes to play tennis on weekends.' and 'Looking for online suggestions.'
```

```python
# 3. Search: search related memories
related_memories = m.search(query="What are Alice's hobbies?", user_id="alice")

# Retrieved memory --> 'Likes to play tennis on weekends'
```

```python
# 4. Get all memories
all_memories = m.get_all()
memory_id = all_memories[0]["id"] # get a memory_id

# All memory items --> 'Likes to play tennis on weekends.' and 'Looking for online suggestions.'
```

```python
# 5. Get memory history for a particular memory_id
history = m.history(memory_id=<memory_id_1>)

# Logs corresponding to memory_id_1 --> {'prev_value': 'Working on improving tennis skills and interested in online courses for tennis.', 'new_value': 'Likes to play tennis on weekends' }
```

### Mem0 Platform

```python
from mem0 import MemoryClient
client = MemoryClient(api_key="your-api-key") # get api_key from https://app.mem0.ai/

# Store messages 
messages = [
    {"role": "user", "content": "Hi, I'm Alex. I'm a vegetarian and I'm allergic to nuts."},
    {"role": "assistant", "content": "Hello Alex! I've noted that you're a vegetarian and have a nut allergy. I'll keep this in mind for any food-related recommendations or discussions."}
]
result = client.add(messages, user_id="alex")
print(result)

# Retrieve memories
all_memories = client.get_all(user_id="alex")
print(all_memories)

# Search memories
query = "What do you know about me?"
related_memories = client.search(query, user_id="alex")

# Get memory history
history = client.history(memory_id="m1")
print(history)
```

> [!TIP]
> If you are looking for a hosted version and don't want to setup the infrastucture yourself, checkout [Mem0 Platform Docs](https://docs.mem0.ai/platform/quickstart) to get started in minutes.

## πŸ”‘ Core Features

- **Multi-Level Memory**: User, Session, and AI Agent memory retention
- **Adaptive Personalization**: Continuous improvement based on interactions
- **Developer-Friendly API**: Simple integration into various applications
- **Cross-Platform Consistency**: Uniform behavior across devices
- **Managed Service**: Hassle-free hosted solution

## πŸ“– Documentation

For detailed usage instructions and API reference, visit our documentation at [docs.mem0.ai](https://docs.mem0.ai).

## πŸ”§ Advanced Usage

For production environments, you can use Qdrant as a vector store:

```python
from mem0 import Memory

config = {
    "vector_store": {
        "provider": "qdrant",
        "config": {
            "host": "localhost",
            "port": 6333,
        }
    },
}

m = Memory.from_config(config)
```

## πŸ—ΊοΈ Roadmap

- Integration with various LLM providers
- Support for LLM frameworks
- Integration with AI Agents frameworks
- Customizable memory creation/update rules
- Hosted platform support

## πŸ’° Pricing

Choose the Mem0 plan that best fits your needs:

### Open Source (Self-hosted)
Perfect for developers and small teams who want full control over their infrastructure.

### Pro (Hosted)
Ideal for growing businesses that need a reliable, managed solution with generous free usage. Try the platform [here](https://app.mem0.ai)

### Enterprise (Hosted)
Designed for large organizations with advanced security, compliance, and scalability needs.

| Feature | Open Source | Pro | Enterprise |
|---------|-------------|-----|------------|
| Hosting | Self-hosted | Hosted | Hosted |
| API Calls | Unlimited | 100K free/month | Custom limits |
| Support | Community | Email | Dedicated support |
| Updates | Manual | Automatic | Automatic |
| SSO | ❌ | ❌ | βœ… |
| Audit Logs | ❌ | ❌ | βœ… |
| Custom Integrations | ❌ | ❌ | βœ… |
| SLA | ❌ | ❌ | βœ… |
| Advanced Analytics | ❌ | Basic | Advanced |
| Multi-region Deployment | ❌ | ❌ | βœ… |

[Contact us](mailto:taranjeet@mem0.ai) for Enterprise pricing and custom solutions.

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=mem0ai/mem0&type=Date)](https://star-history.com/#mem0ai/mem0&Date)

## πŸ™‹β€β™‚οΈ Support
Join our Slack or Discord community for support and discussions.
If you have any questions, feel free to reach out to us using one of the following methods:

- [Join our Discord](https://mem0.ai/discord)
- [Join our Slack](https://mem0.ai/slack)
- [Join our newsletter](https://mem0.ai/email)
- [Follow us on Twitter](https://x.com/mem0ai)
- [Email us](mailto:founders@mem0.ai)

## πŸ“ License

This project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.

> [!NOTE]
> The Mem0 repository now also includes the Embedchain project. We continue to maintain and support Embedchain ❀️. You can find the Embedchain codebase in the [embedchain](https://github.com/mem0ai/mem0/tree/main/embedchain) directory.
            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "mem0ai-101deploy",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<4.0,>=3.8",
    "maintainer_email": null,
    "keywords": null,
    "author": "Mem0",
    "author_email": "founders@mem0.ai",
    "download_url": "https://files.pythonhosted.org/packages/25/ff/6b463d32ed8223bd6fd9f16d5ea5f7b3b8c09dcea4abf23e7b3c45195705/mem0ai_101deploy-0.0.13a0.tar.gz",
    "platform": null,
    "description": "<p align=\"center\">\n  <img src=\"docs/images/banner.png\" width=\"800px\" alt=\"Mem0 Logo\">\n</p>\n\n<p align=\"center\">\n  <a href=\"https://mem0.ai/slack\">\n    <img src=\"https://img.shields.io/badge/slack-mem0-brightgreen.svg?logo=slack\" alt=\"Mem0 Slack\">\n  </a>\n  <a href=\"https://mem0.ai/discord\">\n    <img src=\"https://dcbadge.vercel.app/api/server/6PzXDgEjG5?style=flat\" alt=\"Mem0 Discord\">\n  </a>\n  <a href=\"https://x.com/mem0ai\">\n    <img src=\"https://img.shields.io/twitter/follow/mem0ai\" alt=\"Mem0 Twitter\">\n  </a>\n  <a href=\"https://www.ycombinator.com/companies/mem0\"><img src=\"https://img.shields.io/badge/Y%20Combinator-S24-orange?style=flat-square\" alt=\"Y Combinator S24\"></a>\n  <a href=\"https://www.npmjs.com/package/mem0ai\"><img src=\"https://img.shields.io/npm/v/mem0ai?style=flat-square&label=npm+mem0ai\" alt=\"mem0ai npm package\"></a>\n  <a href=\"https://pypi.python.org/pypi/mem0ai\"><img src=\"https://img.shields.io/pypi/v/mem0ai.svg?style=flat-square&label=pypi+mem0ai\" alt=\"mem0ai Python package on PyPi\"></a>\n  <a href=\"https://mem0.ai/email\"><img src=\"https://img.shields.io/badge/substack-mem0-brightgreen.svg?logo=substack&label=mem0+substack\" alt=\"Mem0 newsletter\"></a>\n</p>\n\n# Mem0: The Memory Layer for Personalized AI\n\nMem0 provides an intelligent, adaptive memory layer for Large Language Models (LLMs), enhancing personalized AI experiences by retaining and utilizing contextual information across diverse applications. This enhanced memory capability is crucial for applications ranging from customer support and healthcare diagnostics to autonomous systems and personalized content recommendations, allowing AI to remember user preferences, adapt to individual needs, and continuously improve over time.\n\n## \ud83d\ude80 Quickstart\n\n### Installation\n\nThe Mem0 package can be installed directly from pip command in the terminal.\n\n```bash\npip install mem0ai\n```\n\n### Basic Usage (Open Source)\n\nMem0 supports various LLMs, details of which can be found in our docs, checkout [Supported LLMs](https://docs.mem0.ai/llms). By default, Mem0 is equipped with ```gpt-4o```, and to use it, you need to set the keys in the environment variable.\n\n```python\nimport os\nos.environ[\"OPENAI_API_KEY\"] = \"sk-xxx\"\n```\n\nNow, you can simply initialize the memory.\n\n```python\nfrom mem0 import Memory\n\nm = Memory()\n```\n\nYou can perform the following task on the memory.\n1. Add: adds memory\n2. Update: update memory of a given memory_id\n3. Search: fetch memories based on a query\n4. Get: return memories for a certain user/agent/session\n5. History: describes how a memory has changed over time for a specific memory ID\n\n```python\n# 1. Add: Store a memory from any unstructured text\nresult = m.add(\"I am working on improving my tennis skills. Suggest some online courses.\", user_id=\"alice\", metadata={\"category\": \"hobbies\"})\n\n# Created memory --> 'Improving her tennis skills.' and 'Looking for online suggestions.'\n```\n\n```python\n# 2. Update: update the memory\nresult = m.update(memory_id=<memory_id_1>, data=\"Likes to play tennis on weekends\")\n\n# Updated memory --> 'Likes to play tennis on weekends.' and 'Looking for online suggestions.'\n```\n\n```python\n# 3. Search: search related memories\nrelated_memories = m.search(query=\"What are Alice's hobbies?\", user_id=\"alice\")\n\n# Retrieved memory --> 'Likes to play tennis on weekends'\n```\n\n```python\n# 4. Get all memories\nall_memories = m.get_all()\nmemory_id = all_memories[0][\"id\"] # get a memory_id\n\n# All memory items --> 'Likes to play tennis on weekends.' and 'Looking for online suggestions.'\n```\n\n```python\n# 5. Get memory history for a particular memory_id\nhistory = m.history(memory_id=<memory_id_1>)\n\n# Logs corresponding to memory_id_1 --> {'prev_value': 'Working on improving tennis skills and interested in online courses for tennis.', 'new_value': 'Likes to play tennis on weekends' }\n```\n\n### Mem0 Platform\n\n```python\nfrom mem0 import MemoryClient\nclient = MemoryClient(api_key=\"your-api-key\") # get api_key from https://app.mem0.ai/\n\n# Store messages \nmessages = [\n    {\"role\": \"user\", \"content\": \"Hi, I'm Alex. I'm a vegetarian and I'm allergic to nuts.\"},\n    {\"role\": \"assistant\", \"content\": \"Hello Alex! I've noted that you're a vegetarian and have a nut allergy. I'll keep this in mind for any food-related recommendations or discussions.\"}\n]\nresult = client.add(messages, user_id=\"alex\")\nprint(result)\n\n# Retrieve memories\nall_memories = client.get_all(user_id=\"alex\")\nprint(all_memories)\n\n# Search memories\nquery = \"What do you know about me?\"\nrelated_memories = client.search(query, user_id=\"alex\")\n\n# Get memory history\nhistory = client.history(memory_id=\"m1\")\nprint(history)\n```\n\n> [!TIP]\n> If you are looking for a hosted version and don't want to setup the infrastucture yourself, checkout [Mem0 Platform Docs](https://docs.mem0.ai/platform/quickstart) to get started in minutes.\n\n## \ud83d\udd11 Core Features\n\n- **Multi-Level Memory**: User, Session, and AI Agent memory retention\n- **Adaptive Personalization**: Continuous improvement based on interactions\n- **Developer-Friendly API**: Simple integration into various applications\n- **Cross-Platform Consistency**: Uniform behavior across devices\n- **Managed Service**: Hassle-free hosted solution\n\n## \ud83d\udcd6 Documentation\n\nFor detailed usage instructions and API reference, visit our documentation at [docs.mem0.ai](https://docs.mem0.ai).\n\n## \ud83d\udd27 Advanced Usage\n\nFor production environments, you can use Qdrant as a vector store:\n\n```python\nfrom mem0 import Memory\n\nconfig = {\n    \"vector_store\": {\n        \"provider\": \"qdrant\",\n        \"config\": {\n            \"host\": \"localhost\",\n            \"port\": 6333,\n        }\n    },\n}\n\nm = Memory.from_config(config)\n```\n\n## \ud83d\uddfa\ufe0f Roadmap\n\n- Integration with various LLM providers\n- Support for LLM frameworks\n- Integration with AI Agents frameworks\n- Customizable memory creation/update rules\n- Hosted platform support\n\n## \ud83d\udcb0 Pricing\n\nChoose the Mem0 plan that best fits your needs:\n\n### Open Source (Self-hosted)\nPerfect for developers and small teams who want full control over their infrastructure.\n\n### Pro (Hosted)\nIdeal for growing businesses that need a reliable, managed solution with generous free usage. Try the platform [here](https://app.mem0.ai)\n\n### Enterprise (Hosted)\nDesigned for large organizations with advanced security, compliance, and scalability needs.\n\n| Feature | Open Source | Pro | Enterprise |\n|---------|-------------|-----|------------|\n| Hosting | Self-hosted | Hosted | Hosted |\n| API Calls | Unlimited | 100K free/month | Custom limits |\n| Support | Community | Email | Dedicated support |\n| Updates | Manual | Automatic | Automatic |\n| SSO | \u274c | \u274c | \u2705 |\n| Audit Logs | \u274c | \u274c | \u2705 |\n| Custom Integrations | \u274c | \u274c | \u2705 |\n| SLA | \u274c | \u274c | \u2705 |\n| Advanced Analytics | \u274c | Basic | Advanced |\n| Multi-region Deployment | \u274c | \u274c | \u2705 |\n\n[Contact us](mailto:taranjeet@mem0.ai) for Enterprise pricing and custom solutions.\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=mem0ai/mem0&type=Date)](https://star-history.com/#mem0ai/mem0&Date)\n\n## \ud83d\ude4b\u200d\u2642\ufe0f Support\nJoin our Slack or Discord community for support and discussions.\nIf you have any questions, feel free to reach out to us using one of the following methods:\n\n- [Join our Discord](https://mem0.ai/discord)\n- [Join our Slack](https://mem0.ai/slack)\n- [Join our newsletter](https://mem0.ai/email)\n- [Follow us on Twitter](https://x.com/mem0ai)\n- [Email us](mailto:founders@mem0.ai)\n\n## \ud83d\udcdd License\n\nThis project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.\n\n> [!NOTE]\n> The Mem0 repository now also includes the Embedchain project. We continue to maintain and support Embedchain \u2764\ufe0f. You can find the Embedchain codebase in the [embedchain](https://github.com/mem0ai/mem0/tree/main/embedchain) directory.",
    "bugtrack_url": null,
    "license": null,
    "summary": "Long-term memory for AI Agents",
    "version": "0.0.13a0",
    "project_urls": null,
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9f861d5379604ce8e731fde6a6cc8ee2240350a7576831768fbaedb99e965298",
                "md5": "014455c8b5813f75e459ab58023aa78c",
                "sha256": "116363b4224e1cd09d58309ebda75b09a70f7087d7da7afd7a1c932579fa579b"
            },
            "downloads": -1,
            "filename": "mem0ai_101deploy-0.0.13a0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "014455c8b5813f75e459ab58023aa78c",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4.0,>=3.8",
            "size": 45863,
            "upload_time": "2024-08-05T10:44:12",
            "upload_time_iso_8601": "2024-08-05T10:44:12.548414Z",
            "url": "https://files.pythonhosted.org/packages/9f/86/1d5379604ce8e731fde6a6cc8ee2240350a7576831768fbaedb99e965298/mem0ai_101deploy-0.0.13a0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "25ff6b463d32ed8223bd6fd9f16d5ea5f7b3b8c09dcea4abf23e7b3c45195705",
                "md5": "a02fb0255e5a79c22389c900be0f6b4f",
                "sha256": "cee096f53078dde0a164f99d5e01e5e2f48bd5b175802c913496c8c274d73bb1"
            },
            "downloads": -1,
            "filename": "mem0ai_101deploy-0.0.13a0.tar.gz",
            "has_sig": false,
            "md5_digest": "a02fb0255e5a79c22389c900be0f6b4f",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4.0,>=3.8",
            "size": 32413,
            "upload_time": "2024-08-05T10:44:13",
            "upload_time_iso_8601": "2024-08-05T10:44:13.865763Z",
            "url": "https://files.pythonhosted.org/packages/25/ff/6b463d32ed8223bd6fd9f16d5ea5f7b3b8c09dcea4abf23e7b3c45195705/mem0ai_101deploy-0.0.13a0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-08-05 10:44:13",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "mem0ai-101deploy"
}
        
Elapsed time: 0.68380s