Framework

Costruisci i tuoi agenti su VAF.

Lo stesso motore che muove l'app desktop, come libreria Python. Un pip install, un Agent senza vincoli di fornitore, i tuoi strumenti e una licenza che ti lascia pubblicare.

Partenza rapida

Tre righe e l'agente gira.

La classe Agent è la superficie stabile del framework. Lo stesso codice esegue un modello GGUF del tutto locale (nulla lascia il computer) o qualunque fornitore di API supportato: veyllo, openai, anthropic, google, deepseek, openrouter.

✓

Streaming incluso. Passa on_token e i delta arrivano man mano che vengono generati.

✓

Le conversazioni persistono. save_session() scrive nello store di sessioni standard; ripassa l'id e riprendi con la memoria intatta.

✓

I tuoi strumenti, trovati da soli. Eredita da BaseTool o pubblica lo strumento come pacchetto pip a sé: l'agente lo trova all'avvio. I server MCP si collegano allo stesso modo.

Leggi la guida all'integrazione Esempi eseguibili

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)

Snello di default

Installa solo ciò che serve al tuo agente.

L'installazione base è il runtime di base più gli SDK dei fornitori. Le funzioni pesanti sono extra facoltativi; uno strumento senza il suo extra semplicemente non si carica, e l'agente continua a girare.

vaf[server]l'API HTTP e WebSocket

vaf[desktop]la finestra desktop e la tray

vaf[memory]memoria RAG a lungo termine (pgvector)

vaf[speech]trascrizione offline

vaf[browser]strumenti di automazione del browser

vaf[pdf]estrazione PDF e OCR

vaf[docs]strumenti per documenti Office

vaf[all]tutto, alla pari del prodotto completo

Licenza

I tuoi strumenti restano tuoi.

VAF è open source sotto AGPL-3.0, con un permesso esplicito in più: plugin, strumenti e flussi che parlano con VAF attraverso le interfacce pubbliche possono uscire con la licenza che scegli tu, condizioni proprietarie comprese. Per integrare VAF stesso in un prodotto chiuso o in un SaaS c'è una licenza commerciale.

pip install, e si costruisce.

La guida all'integrazione percorre passo passo strumenti, sessioni, uso asincrono e packaging.

Leggi la guida all'integrazione Get an API key