Repolode
wanxingai

wanxingai/LightAgent

Framework Python leve para criar agentes compatíveis com OpenAI, com ferramentas, memória, guardrails, tracing, hooks, roteamento multiagente e workflows.

Estrelas
1,243
Forks
180
Issues abertas
2
Último commit
há 10 dias

O que é?

LightAgent é um framework Python para criar agentes de LLM que funcionam com modelos compatíveis com OpenAI e geram respostas em streaming. Ele foi desenvolvido sem LangChain ou LlamaIndex e oferece ferramentas Python personalizadas, além de integração com ferramentas MCP via stdio, SSE e Streamable HTTP. A memória é pluggable, com suporte nativo ao módulo mem0 e isolamento por usuário usando user_id e MemoryPolicy.

Além de agentes individuais, o framework oferece três camadas de orquestração: LightSwarm, para roteamento baseado em funções entre agentes especializados; LightFlow, para workflows DAG determinísticos e com várias etapas, incluindo retries, checkpoints, retomada e etapas de aprovação; e LightDAG, para grafos de tarefas persistentes e verificados dinamicamente. Um runtime opcional baseado em eventos adiciona Sessions duráveis, execução assíncrona e controles de políticas.

Para uso em produção, inclui guardrails de entrada, ferramentas e saída, hooks de runtime ordenados, exportação de traces opcional, um harness determinístico de avaliação e aprovação humana para ferramentas de alto risco. A documentação explica como configurar provedores de modelos como OpenRouter, vLLM, llama.cpp e outros endpoints compatíveis.

Recursos principais

  • 01Oferece suporte a ferramentas Python personalizadas e servidores MCP via stdio, SSE e Streamable HTTP.
  • 02Backends de memória pluggable, com suporte nativo ao mem0 e isolamento por usuário.
  • 03LightSwarm encaminha solicitações entre agentes especializados com funções definidas.
  • 04LightFlow executa workflows DAG com retries, checkpoints, retomada e etapas de aprovação.
  • 05Guardrails de entrada, ferramentas e saída, além de hooks de runtime ordenados para aplicar políticas.
  • 06Traces de execução opcionais, exportação de traces e um harness determinístico de avaliação.

Casos de uso

  • Criar um chatbot ou assistente que chama APIs internas como ferramentas.
  • Encaminhar solicitações de clientes para agentes especializados, como suporte, financeiro ou RH.
  • Executar workflows com várias etapas que exigem retries, checkpoints e aprovação humana.
  • Conectar um modelo auto-hospedado, como vLLM ou llama.cpp, a um agente com ferramentas.

Antes de usar

  • O projeto ainda está antes da versão 1.0 (v0.11.0), e o README menciona um esforço para estabilizar a API; portanto, podem ocorrer mudanças incompatíveis.
  • Ferramentas legadas que executam Python arbitrário são bloqueadas no despacho de modelos e ferramentas, então as ferramentas devem usar safe_expression ou uma ferramenta isolada personalizada.

Em coleções

Tópicos

Perguntas frequentes

O que é LightAgent?
Framework Python leve para criar agentes compatíveis com OpenAI, com ferramentas, memória, guardrails, tracing, hooks, roteamento multiagente e workflows. LightAgent é um framework Python para criar agentes de LLM que funcionam com modelos compatíveis com OpenAI e geram respostas em streaming. Ele foi desenvolvido sem LangChain ou LlamaIndex e oferece ferramentas Python personalizadas, além de integração com ferramentas MCP via stdio, SSE e Streamable HTTP. A memória é pluggable, com suporte nativo ao módulo mem0 e isolamento por usuário usando user_id e MemoryPolicy.
LightAgent é gratuito? Qual é a licença?
LightAgent é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
LightAgent ainda é mantido?
Manutenção ativa. O último commit de LightAgent foi em 28 de out. de 2026.
Para que posso usar LightAgent?
Criar um chatbot ou assistente que chama APIs internas como ferramentas. Encaminhar solicitações de clientes para agentes especializados, como suporte, financeiro ou RH. Executar workflows com várias etapas que exigem retries, checkpoints e aprovação humana. Conectar um modelo auto-hospedado, como vLLM ou llama.cpp, a um agente com ferramentas.
Onde consigo LightAgent?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/wanxingai/LightAgent

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados