O que praxis faz?
Framework local-first de RAG e habilidades de agente para memória de agente com rastreabilidade de fonte.
Visão Geral
O Praxis fornece uma base para construir agentes de IA que precisam de memória persistente e rastreável. Ao contrário de soluções baseadas apenas em nuvem, o Praxis mantém os dados localmente, dando a você controle total sobre suas informações.
Recursos Principais
- Local-First: Todos os dados de memória são armazenados localmente, sem dependência de serviços externos.
- RAG Incorporado: Suporte nativo a Retrieval-Augmented Generation para busca contextual.
- Rastreabilidade de Fonte: Cada item de memória é vinculado à sua fonte original, garantindo verificabilidade.
- Múltiplos Backends: Suporte a diferentes mecanismos de armazenamento (ex.: SQLite, arquivos locais).
- API Simples: Interface consistente para integração com agentes como Claude Code, Cursor e Codex.
Instalação
npm install @sparkplug604/praxis
ou
yarn add @sparkplug604/praxis
Uso Rápido
import { Praxis } from '@sparkplug604/praxis';
const mem = new Praxis({ storage: 'sqlite', path: './memoria.db' });
await mem.remember('config_api', { url: 'https://api.exemplo.com', chave: 'abc123' });
const resultado = await mem.recall('config_api');
console.log(resultado);
// { url: 'https://api.exemplo.com', chave: 'abc123' }
Configuração
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
storage | string | 'json' | Backend de armazenamento (json, sqlite, etc.) |
path | string | './praxis.json' | Caminho para o arquivo/database de armazenamento |
Exemplo com Agente
// Integração com Claude Code ou Cursor
const agente = new Agente({
memoria: new Praxis({ storage: 'sqlite' })
});
await agente.executar('Lembrar que o projeto usa React 18');
// A memória é armazenada com rastreabilidade para a conversa atual
Contribuição
Contribuições são bem-vindas! Consulte o arquivo CONTRIBUTING.md para diretrizes.