ArchiveNet

Um servidor de inserção e busca de contexto para Claude Desktop e Cursor IDE, utilizando endpoints de API configuráveis.

Documentação

ArchiveNET

Onde as memórias de IA vivem para sempre - Uma plataforma descentralizada de memória semântica alimentada por blockchain e busca vetorial

Hackathon Project Arweave TypeScript Node.js Docker PostgreSQL Next.js Redis

License Build Status AI Powered Blockchain

ArchiveNET é uma plataforma revolucionária de gerenciamento de memória descentralizada que combina o poder de embeddings de IA com a permanência do blockchain. Construída sobre Arweave, ela oferece capacidades de busca semântica de nível empresarial por meio de tecnologia avançada de banco de dados vetorial, permitindo que aplicações armazenem, busquem e recuperem informações contextuais com permanência e precisão sem precedentes.

Principais Recursos

  • Memória Semântica: Armazenamento e recuperação de memória contextual alimentados por IA
  • Persistência em Blockchain: Armazenamento permanente no blockchain Arweave
  • Busca Vetorial: Algoritmo HNSW de última geração para busca por similaridade
  • Alto Desempenho: Complexidade de busca O(log N) para milhões de vetores
  • Descentralizado: Sem ponto único de falha ou censura
  • Metadados Ricos: Suporte abrangente a metadados para busca aprimorada
  • Pronto para Empresas: API de nível de produção com autenticação e monitoramento

Arquitetura

ArchiveNET

ArchiveNET é um monorepo abrangente composto por quatro componentes principais:

Eizen - Mecanismo de Banco de Dados Vetorial

O primeiro mecanismo vetorial descentralizado do mundo construído no blockchain Arweave, implementando o algoritmo Hierarchical Navigable Small Worlds (HNSW) para busca aproximada do vizinho mais próximo.

Principais Recursos:

  • Algoritmo HNSW com complexidade O(log N)
  • Persistência baseada em blockchain via HollowDB
  • Codificação Protobuf para armazenamento eficiente
  • Interface agnóstica de banco de dados
  • Lida com milhões de vetores de alta dimensão

API - Serviço de Backend

Um serviço de API Express.js robusto que fornece gerenciamento de memória semântica com capacidades de busca alimentadas por IA.

Stack:

  • Express.js com TypeScript
  • Neon PostgreSQL com Drizzle ORM
  • EizenDB para operações vetoriais
  • Redis para cache
  • Autenticação JWT
  • Validação abrangente com Zod

Frontend - Interface Web

Uma aplicação Next.js moderna que fornece uma interface intuitiva para operações de gerenciamento de memória e busca.

Recursos:

  • Interface baseada em React com TypeScript
  • Capacidades de busca em tempo real
  • Visualização de memória
  • Painel do usuário
  • Design responsivo

Eva - Agente MCP

O servidor central do Model Context Protocol (MCP) que orquestra operações de memória e fornece gerenciamento inteligente de contexto.

Início Rápido

Pré-requisitos

  • Node.js 18+
  • Docker e Docker Compose
  • Banco de dados PostgreSQL
  • Servidor Redis
  • Carteira Arweave

Instalação

  1. Clone o repositório:

    git clone https://github.com/s9swata/archivenet.git
    cd ArchiveNET
    
  2. Inicie com Docker Compose:

    docker-compose up -d
    
  3. Configuração manual (alternativa):

    # API Setup
    cd API
    npm install
    npm run build
    npx drizzle-kit push
    npm run dev
    
    # Frontend Setup
    cd ../client
    npm install
    npm run dev
    
    

Configuration

Create .env files in respective directories:

API/.env:

DATABASE_URL=your_postgres_url
REDIS_URL=redis://localhost:6379
JWT_SECRET=your_jwt_secret
ARWEAVE_WALLET_PATH=./data/wallet.json

Integração com a API

// Store a memory
const response = await fetch("/api/memories", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    content: "Project discussion about AI integration",
    metadata: { project: "AI-Platform", priority: "high" },
  }),
});

// Search memories
const searchResults = await fetch("/api/memories/search", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    query: "AI project discussions",
    limit: 10,
  }),
});

Contribuindo

  1. Faça um fork do repositório
  2. Crie um branch de recurso (git checkout -b feature/amazing-feature)
  3. Faça commit das suas alterações (git commit -m 'Add amazing feature')
  4. Envie para o branch (git push origin feature/amazing-feature)
  5. Abra um Pull Request

Documentação

Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.


Feito com ❤️ para o futuro da IA descentralizada