Package Exports

permamind
permamind/dist/server.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (permamind) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Permamind 🧠⚡️

The world's first permanent, decentralized AI memory system built on Arweave and AO

Permamind is a Model Context Protocol (MCP) server that provides an immortal memory layer for AI agents, leveraging Arweave's permanent storage and the AO ecosystem for decentralized computation. Unlike traditional memory systems that are ephemeral and centralized, Permamind creates truly persistent AI memory that survives forever.

🌟 Why Permamind?

Traditional AI Memory	Permamind
❌ Ephemeral sessions	✅ Permanent storage
❌ Centralized servers	✅ Decentralized AO network
❌ Limited context	✅ Unlimited knowledge graphs
❌ No cross-session learning	✅ Continuous learning & memory
❌ Vendor lock-in	✅ Open, permissionless protocol

🚀 Key Features

🧠 Immortal AI Memory

Permanent Storage: All memories stored forever on Arweave blockchain
Rich Metadata: Context, importance scoring, and semantic relationships
Memory Types: Conversation, reasoning, knowledge, procedures, workflows
Advanced Search: Multi-filter, relevance-ranked memory retrieval

🌐 Decentralized Architecture

AO-Powered: Leverage AO compute layer for decentralized processing
Hub System: Distributed memory nodes with the Velocity Protocol
Permissionless: No gatekeepers, true Web3 infrastructure
Cross-Agent Memory: Shared knowledge between AI systems

🔗 Knowledge Graphs

Memory Relationships: Link related concepts with typed connections
Reasoning Chains: Document AI decision-making processes
Circular Reference Detection: Maintain graph integrity
Shortest Path Analysis: Navigate knowledge networks efficiently

🛠 Universal AO Integration

Complete Process Lifecycle: Create → Evaluate → Communicate → Query workflows
Natural Language Interface: Talk to any AO process in plain English
Lua Code Evaluation: Execute and test code directly within AO processes
Process Creation: Spawn new AO processes with optional template support
Message History: Query and monitor all process communications
Markdown Documentation: Simple process documentation format
Token Operations: Advanced minting strategies and credit notice system
Smart Templates: Auto-detect common process types (tokens, NFTs, DAOs)

🎯 Developer Experience

MCP Native: Works with Claude, VS Code, Cursor, and more
TypeScript First: Full type safety and excellent DX
Zero Config: Automatic wallet generation and hub deployment
Comprehensive Testing: 95%+ test coverage with Vitest

📚 Documentation

📖 Core Guides

🚀 Installation & Quick Start - Get up and running in 5 minutes
🛠 MCP Tools Reference - Complete API documentation
💡 Usage Examples - Practical code examples and patterns
🏗 Architecture & Configuration - Technical deep dive and advanced setup

🔧 Support & Development

🚨 Troubleshooting - Common issues and solutions
🤝 Contributing Guide - Join the development community
🧪 Testing Guide - Quality assurance and testing patterns

🌐 Integration Guides

AO Process Integration - Connect any AO process
Process Management Workflows - Complete lifecycle examples
Token Development - Build token systems
Knowledge Graphs - Memory relationships
MCP Client Setup - Configure Claude, VS Code, etc.

📊 Advanced Topics

Custom Process Templates - Extend functionality
Performance Optimization - Scale your implementation
Security Considerations - Best practices and hardening
Deployment Strategies - Production deployment

🏗 Architecture Overview

graph TD
    A[AI Agent/Claude] --> B[Permamind MCP Server]
    B --> C[AO Process Layer]
    B --> D[Arweave Storage]

    C --> E[Memory Hub]
    C --> F[Token Processes]
    C --> G[Custom AO Processes]

    E --> H[Enhanced Memory Service]
    E --> I[Knowledge Graph Service]
    E --> J[Analytics Service]

    D --> K[Permanent Memory Storage]
    D --> L[Hub Registry]
    D --> M[Process Templates]

Core Components:

MCP Server: FastMCP-based server exposing AI memory tools
AO Integration: Direct communication with AO processes
Memory Services: Enhanced AI memory with metadata and relationships
Token System: Advanced minting strategies with credit notice detection
Velocity Protocol: Decentralized hub discovery and event routing

🌐 Ecosystem & Links

Core Technologies

AO Cookbook - AO development guide and compute layer
Arweave - Permanent data storage
Model Context Protocol - AI tool standard
FastMCP - TypeScript MCP framework
Velocity Protocol - Decentralized social protocol

Community & Support

GitHub: https://github.com/ALLiDoizCode/Permamind
Documentation: https://permamind.ai/docs (coming soon)
Community: Discord (coming soon)
Updates: @ALLiDoizCode

AO Cookbook - AO development guide
Arweave Cookbook - Arweave development
Claude Desktop - Primary MCP client

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

AO & Arweave Teams - For building the permanent compute and storage layers
Anthropic - For creating the Model Context Protocol standard
FastMCP Contributors - For the excellent TypeScript MCP framework
Community Contributors - For feedback, testing, and contributions

🧠 Building the Future of AI Memory 🧠

Permanent • Decentralized • Immortal

🚀 Get Started • 📚 Documentation • 💡 Examples • 🤝 Community

permamind