如何在5分钟内开始使用MemoRizz：零基础入门教程

如何在5分钟内开始使用MemoRizz零基础入门教程【免费下载链接】memorizzMemoRizz: A Python library serving as a memory layer for AI applications. Leverages popular databases and storage solutions to optimize memory usage. Provides utility classes and methods for efficient data management.项目地址: https://gitcode.com/gh_mirrors/me/memorizzMemoRizz是一个强大的Python库作为AI应用程序的记忆层它利用流行的数据库和存储解决方案来优化内存使用提供高效数据管理的实用类和方法。本教程将帮助你快速上手无需复杂的技术背景只需按照简单步骤即可在5分钟内启动并运行MemoRizz。准备工作所需工具和环境在开始前请确保你的系统已安装以下必要软件Python 3.7MemoRizz基于Python开发需要3.7或更高版本。你可以通过python --version或python3 --version命令检查当前安装的Python版本。Docker用于在本地运行Oracle数据库。你可以从docker.com下载并安装Docker。安装完成后通过docker --version命令验证是否安装成功。Git用于克隆MemoRizz仓库如果从源代码安装。第1步快速安装MemoRizz安装MemoRizz非常简单只需在终端中运行以下命令# 安装MemoRizz核心库 pip install memorizz # 安装Oracle数据库驱动如果使用Oracle作为存储 pip install oracledb # 安装OpenAI SDK用于LLM和嵌入功能 pip install openai如果你需要使用Hugging Face相关功能可以安装额外的依赖pip install memorizz[huggingface]第2步启动Oracle数据库可选MemoRizz支持多种存储解决方案其中Oracle数据库提供了强大的AI向量搜索功能。如果你选择使用Oracle可以通过以下命令快速启动# 启动Oracle数据库推荐使用轻量级镜像 memorizz oracle install --image lite对于Apple SiliconM1/M2/M3用户可能需要添加平台标志export PLATFORM_FLAG--platform linux/amd64 memorizz oracle install --image lite这个命令会自动拉取Oracle数据库镜像创建并启动容器并设置持久化存储卷。默认连接信息如下主机localhost端口1521服务名FREEPDB1管理员用户system管理员密码MyPassword123!第3步配置数据库模式启动Oracle数据库后需要设置数据库模式# 设置数据库模式 memorizz oracle setup这个命令会自动创建必要的用户、表和视图为MemoRizz提供存储结构。默认情况下会创建一个名为memorizz_user的用户密码为SecurePass123!。第4步设置环境变量为了让MemoRizz能够连接到数据库和AI服务需要设置一些环境变量。你可以创建一个.env文件内容如下OPENAI_API_KEY你的OpenAI API密钥 ORACLE_USERmemorizz_user ORACLE_PASSWORDSecurePass123! ORACLE_DSNlocalhost:1521/FREEPDB1然后在Python代码中加载这些环境变量from dotenv import load_dotenv load_dotenv() # 加载.env文件中的环境变量如果你没有安装python-dotenv可以通过pip install python-dotenv命令安装。第5步创建你的第一个AI代理现在你已经准备好创建第一个使用MemoRizz的AI代理了。以下是一个简单的示例import os from memorizz.memory_provider.oracle import OracleProvider, OracleConfig from memorizz.memagent.builders import MemAgentBuilder # 配置Oracle存储提供器 oracle_config OracleConfig( useros.environ.get(ORACLE_USER, memorizz_user), passwordos.environ.get(ORACLE_PASSWORD, SecurePass123!), dsnos.environ.get(ORACLE_DSN, localhost:1521/FREEPDB1), embedding_provideropenai, embedding_config{ model: text-embedding-3-small, api_key: os.environ[OPENAI_API_KEY] } ) oracle_provider OracleProvider(oracle_config) # 创建AI代理 agent (MemAgentBuilder() .with_instruction(你是一个有持久记忆的 helpful 助手。) .with_memory_provider(oracle_provider) .with_llm_config({ provider: openai, model: gpt-4o-mini, api_key: os.environ[OPENAI_API_KEY] }) .build() ) # 保存代理到数据库 agent.save() # 开始对话 response agent.run(你好我叫小明我喜欢打篮球。) print(response) # 在另一个会话中... response agent.run(我告诉过你我叫什么名字吗) print(response) # 代理会记得小明喜欢打篮球探索更多功能MemoRizz提供了许多强大的功能你可以通过以下方式进一步探索示例代码查看examples/目录下的Jupyter笔记本了解不同场景下的使用方法。文档阅读docs/目录下的文档深入了解MemoRizz的架构和功能。内存类型MemoRizz支持多种内存类型包括情景记忆、程序记忆和语义记忆你可以在src/memorizz/long_term/目录中找到相关实现。常见问题解决如果你在使用过程中遇到问题可以尝试以下解决方法Oracle连接问题确保Oracle容器正在运行可以通过docker ps | grep oracle-memorizz命令检查。API密钥问题确保OpenAI API密钥正确设置并且有足够的权限。依赖问题如果遇到导入错误检查是否安装了所有必要的依赖包。通过以上步骤你已经成功启动并运行了MemoRizz。现在你可以开始构建具有持久记忆的AI应用程序了祝你的AI项目开发顺利【免费下载链接】memorizzMemoRizz: A Python library serving as a memory layer for AI applications. Leverages popular databases and storage solutions to optimize memory usage. Provides utility classes and methods for efficient data management.项目地址: https://gitcode.com/gh_mirrors/me/memorizz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考