API SDK
Documentação Oficial

Clara Context

Plataforma completa de gerenciamento de contexto com memória infinita para aplicações LLM

Bem-vindo ao Clara Context

Uma plataforma completa que combina o poder de Graphiti (Neo4j) com RAG (pgvector), PydanticAI e múltiplos provedores LLM para criar assistentes de IA com memória infinita e contexto persistente.

O que é Clara Context?

Memória Infinita

Utilizando Graphiti e Neo4j, Clara armazena e recupera contexto de conversas passadas, preferências de usuários e informações relevantes através de grafos de conhecimento.

RAG Avançado

Sistema de Retrieval Augmented Generation com pgvector para busca semântica eficiente em documentos, permitindo respostas precisas baseadas em conhecimento específico.

Multi-LLM

Suporte para múltiplos provedores (OpenAI, Anthropic, Google, Groq, Ollama) com fallback automático e otimização de custos através do PydanticAI.

Colaborativo

Sistema de projetos e grupos para trabalho em equipe, com controle de acesso, roles (owner, admin, member, viewer) e gerenciamento de permissões.

Arquitetura

Stack Tecnológico

Frontend

  • Next.js 15 - Framework React com SSR
  • TypeScript - Type safety
  • Tailwind CSS - Estilização
  • NextAuth.js - Autenticação OAuth

Backend

  • FastAPI - API REST assíncrona
  • SQLAlchemy 2.0 - ORM
  • PydanticAI - Framework de agentes
  • JWT - Autenticação stateless

Bancos de Dados

  • PostgreSQL + pgvector - Dados e vetores
  • Neo4j - Grafo de conhecimento
  • Redis - Cache e rate limiting

Deploy

  • Docker - Containerização
  • Docker Compose - Orquestração
  • Caddy - Reverse proxy com SSL

Principais Recursos

Autenticação Completa

  • Login com email/senha (JWT tokens)
  • OAuth 2.0 (Google, GitHub)
  • Refresh tokens (7 dias access, 30 dias refresh)
  • Rate limiting por endpoint)

Gestão de Projetos

  • Workspaces colaborativos
  • Sistema de membros com roles (owner, admin, member, viewer)
  • Projetos públicos e privados
  • Activity logs detalhados

Assistentes Configuráveis

  • Suporte a 5+ provedores LLM (OpenAI, Anthropic, Google, Groq, Ollama)
  • Fallback automático entre modelos
  • Instruções de sistema e contexto customizáveis
  • Tools e function calling

RAG & Vector Storage

  • Embedding automático com OpenAI text-embedding-3
  • Busca semântica com pgvector (cosine similarity)
  • Chunking inteligente de documentos
  • Re-ranking com threshold configurável

Graphiti & Memória

  • Grafo de conhecimento no Neo4j
  • Busca híbrida (BFS + semantic + cross-encoder)
  • Contexto temporal (valid_at, invalid_at)
  • Episodes para rastreamento de interações

Primeiros Passos

Setup com Docker (Recomendado)

# 1. Clone o repositório
git clone <repo-url>
cd claracontexttest

# 2. Configure variáveis de ambiente
cp .env.example .env
# Edite .env com suas credenciais

# 3. Inicie todos os serviços
docker-compose up -d

# 4. Acesse a aplicação
# Frontend: http://localhost:3001
# API Docs: http://localhost:8000/app/docs
# Neo4j Browser: http://localhost:7474

Variáveis de Ambiente Essenciais

  • OPENAI_API_KEY - Sua chave da OpenAI
  • NEO4J_PASSWORD - Senha do Neo4j
  • POSTGRES_PASSWORD - Senha do PostgreSQL
  • JWT_SECRET_KEY - Secret para JWT

Backend SDK

Para desenvolvedores que desejam integrar com o backend Clara Context API, oferecemos uma API REST completa com suporte a autenticação, projetos, assistentes, RAG e integração com Graphiti.

Documentação Completa da API

Acesse a documentação completa do backend SDK com todos os endpoints, exemplos de código, schemas e guias de integração.

Ver Documentação da SDK

Autenticação

JWT tokens, OAuth2, registro e login

POST /api/auth/login

Assistentes

Criar e gerenciar assistentes de IA

POST /api/assistants

Chat & RAG

Chat com contexto e busca vetorial

POST /chat

Projetos

Workspaces colaborativos

POST /api/projects

Casos de Uso

Chatbots Inteligentes

Crie chatbots que lembram de conversas anteriores, preferências do usuário e contexto histórico para fornecer respostas mais personalizadas.

  • Suporte ao cliente 24/7
  • Assistentes pessoais
  • Consultores virtuais

Base de Conhecimento

Sistema RAG para responder perguntas baseadas em documentação interna, manuais, FAQs e políticas da empresa.

  • Busca semântica em documentos
  • Q&A automático
  • Onboarding de funcionários

Recomendações Personalizadas

Use o grafo de conhecimento para entender preferências e comportamentos, gerando recomendações contextualizadas.

  • E-commerce personalizado
  • Curadoria de conteúdo
  • Sugestões de produtos

Análise de Dados

Assistente de análise que compreende contexto de negócio e histórico de análises para fornecer insights mais relevantes.

  • BI conversacional
  • Relatórios automatizados
  • Data exploration

Tecnologias e Integrações

FastAPI

Python Async

Next.js 15

React Framework

PostgreSQL

+ pgvector

Neo4j

Graph DB

Redis

Cache & Queue

OpenAI

GPT-4 & Embeddings

Graphiti

Knowledge Graph

Docker

Containerization

Pronto para começar?

Explore a documentação completa da API e comece a construir assistentes incríveis!

Ver Documentação da API