mem0 AI Memory Layer with Mastra AI Framework

This repository integrates the Mastra AI TypeScript framework with mem0 as an AI memory layer, creating a powerful backend solution with persistent memory capabilities across different agents. While also executing the user queries and generating the output.

Project Overview

This project implements four specialized AI agents that can leverage both Mastra's agent capabilities and mem0's memory persistence:

Agents server Architecture

Github Agent: Interacts with users for GitHub-related queries including repository analysis, user profiles, pull requests, issues, and code exploration.
Email Agent: Generates professional, personalized emails with formatting capabilities.
Editor Agent: Edits and improves email content while maintaining the core message.
Mem0 Agent: Manages the memory layer to store and retrieve information across conversations.

The system also includes a comprehensive workflow that combines these agents to create a GitHub repository analysis and email campaign system.

Tools

GithubUser Tool: Fetch user profiles, repositories, and contribution stats
GithubRepo Tool: Access repository information, contributors, and metadata
GithubPR Tool: Get pull request details and activity
GithubIssues Tool: Retrieve issue details and discussions
GetFilePath Tool: Navigate repository structure
GetFile Tool: Access file contents and metadata
mem0MemorizeTool: Save structured information to the mem0 memory layer
mem0RememberTool: Retrieve information from the mem0 memory

Workflows

Workflow Design	Workflow Architecture

Workflow process from repository analysis to memory storage	Technical implementation of the workflow components

The project includes a comprehensive mem0Workflow that:

Analyzes a GitHub repository to identify contributors
Generates personalized emails to contributors about mem0.ai
Edits emails for professional formatting
Stores all campaign data in the mem0 memory layer

Installation

Clone the repository:

git clone https://github.com/yashksaini-coder/mastra-mem0-backend.git

Install dependencies:

npm install

Set up environment variables in a .env file:

MEM0_API_KEY=your_mem0_api_key
GITHUB_TOKEN=your_github_token
GROQ_API_KEY=your_groq_api_key

Run the project:

mastra dev or npm run dev

Testing the Project

Testing Individual Agents

You can test each agent individually using the Mastra playground or via API calls:

# Start the Mastra playground
mastra dev --dir src

Access the playground at http://localhost:4111

Testing the GitHub Agent

curl -X POST http://localhost:4111/api/agents/GithubAgent/generate \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      { "role": "user", "content": "Get information about the user octocat" }
    ]
  }'

Testing the Email Agent

curl -X POST http://localhost:4111/api/agents/EmailAgent/generate \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      { "role": "user", "content": "Write an email to John about AI technology trends" }
    ]
  }'

Testing the Mem0 Agent

curl -X POST http://localhost:4111/api/agents/mem0Agent/generate \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      { "role": "user", "content": "Remember that my favorite color is blue" }
    ]
  }'

Testing the Workflow

curl -X POST http://localhost:4111/api/workflows/mem0-email-workflow/trigger \
  -H "Content-Type: application/json" \
  -d '{
    "owner": "facebook",
    "repo": "react"
  }'

Project Structure

src/
├── mastra/
│   ├── agents/
│   │   └── index.ts             # Agent definitions
│   ├── integrations/
│   │   └── index.ts             # mem0 integration setup
│   ├── instructions/
│   │   └── gh-user.ts           # GitHub agent instructions
│   ├── tools/
│   │   ├── GithubUser.ts        # GitHub user profile tool
│   │   ├── GithubRepo.ts        # Repository analysis tool
│   │   ├── GithubPR.ts          # Pull request tool
│   │   ├── GithubIssues.ts      # Issues tool
│   │   ├── GetFile.ts           # File content retrieval tool
│   │   ├── GetFilePath.ts       # File path navigation tool
│   │   └── mem0.ts              # Memory tools using mem0
│   ├── workflows/
│   │   └── index.ts             # Workflow definition
│   └── index.ts                 # Mastra initialization
├── utils/                       # Utility functions
└── types/                       # TypeScript type definitions

Features

GitHub Repository Analysis: Analyze repositories, contributors, and code
Email Generation: Create personalized professional emails
Email Editing: Format and improve email content
Memory Persistence: Store and retrieve information across sessions
Workflow Automation: Combine multiple AI agents in a structured workflow
Structured Data Storage: Store complex data structures in mem0

Yash K. Saini

(Author)

👋 Hi there! I'm Yash K. Saini, a self-taught software developer and a computer science student from India.

I love building & contributing to Open Source software solutions & projects that help solve real-world problems.
I want to build products & systems that can benefit & solve problems for many other DEVs.

🌟 If you find this project helpful, please give it a star on GitHub! 🌟

yashksaini-coder/mastra-mem0-backend

ErrorLooks like something went wrong!

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Languages

Error
Looks like something went wrong!

Packages