Framework

Construa seus agentes sobre o VAF.

O mesmo motor que move o aplicativo desktop, como biblioteca Python. Um pip install, um Agent sem amarra a fornecedor, suas próprias ferramentas e uma licença que deixa você publicar.

Começo rápido

Três linhas e o agente roda.

A classe Agent é a superfície estável do framework. O mesmo código roda um modelo GGUF totalmente local (nada sai do computador) ou qualquer provedor de API suportado: veyllo, openai, anthropic, google, deepseek, openrouter.

✓

Streaming incluso. Passe on_token e os deltas chegam conforme são gerados.

✓

As conversas persistem. save_session() grava no repositório de sessões padrão; devolva o id e retome com a memória intacta.

✓

Suas ferramentas, achadas sozinhas. Herde de BaseTool ou publique a ferramenta como pacote pip próprio: o agente a encontra ao iniciar. Servidores MCP conectam do mesmo jeito.

Ler o guia de integração Exemplos executáveis

quickstart.py

from vaf import Agent

# a local GGUF model, or any API provider
agent = Agent(config={"provider": "local"})

answer = agent.run("Summarize my inbox.")
print(answer)

# stream tokens as they arrive
agent.run("Explain async/await.",
    on_token=lambda s: print(s, end=""))

# persist and resume a conversation
sid = agent.save_session()
agent = Agent(config={"provider": "local"}, session=sid)

Enxuto por padrão

Instale só o que o seu agente precisa.

A instalação base é o núcleo e os SDKs dos provedores. Os recursos pesados são extras opcionais; uma ferramenta sem o extra simplesmente não carrega, e o agente segue rodando.

vaf[server]a API HTTP e WebSocket

vaf[desktop]a janela desktop e a bandeja

vaf[memory]memória RAG de longo prazo (pgvector)

vaf[speech]transcrição offline

vaf[browser]ferramentas de automação do navegador

vaf[pdf]extração de PDF e OCR

vaf[docs]ferramentas para documentos Office

vaf[all]tudo, no nível do produto completo

Licença

Suas ferramentas continuam suas.

O VAF é código aberto sob AGPL-3.0, com uma permissão explícita por cima: plugins, ferramentas e fluxos que falam com o VAF pelas interfaces públicas podem ser publicados sob a licença que você escolher, condições proprietárias incluídas. Para embutir o próprio VAF num produto fechado ou SaaS existe uma licença comercial.

pip install, e mãos à obra.

O guia de integração percorre passo a passo as ferramentas, as sessões, o uso assíncrono e o empacotamento.

Ler o guia de integração Get an API key