Repolode
sahenjp

sahenjp/RustXNG

Um mecanismo de busca na web self-hosted e sem API keys, feito em Rust, que retorna resultados classificados e o texto das páginas para embasar agentes de IA locais.

Alternativa open source a:TavilyExa

Estrelas
869
Forks
66
Issues abertas
17
Último commit
há 13 horas

O que é?

RustXNG é um serviço de busca na web self-hosted, desenvolvido para agentes de IA. É uma portabilidade do SearXNG para Rust que agrega resultados de vários mecanismos de busca e, em uma única requisição, também pode retornar o texto extraído das páginas mais relevantes. Assim, o agente pode responder com base em fontes, em vez de depender da memória. Não são necessárias API keys nem há cobrança por consulta, e os termos de busca são processados na máquina do usuário.

O serviço oferece um endpoint JSON compatível com o SearXNG e uma interface para navegador. Por padrão, consulta cerca de 180 mecanismos em paralelo, com timeouts por mecanismo, suspensão com backoff e pausas automáticas para os mecanismos que continuam sem retornar resultados. Os resultados são classificados pela cobertura dos termos, autoridade do site e correspondência de identificadores, e depois deduplicados. As requisições de saída são limitadas a endereços públicos como proteção contra SSRF, algo importante quando as URLs vêm de conteúdo não confiável. Um índice local experimental opcional pode rastrear seu próprio corpus e classificar resultados com BM25.

O projeto é distribuído como binário pré-compilado, instalação via Cargo, imagem Docker ou compilação a partir do código-fonte, que exige Rust 1.85 ou superior. Os endpoints operacionais incluem /healthz e /metrics, no formato OpenMetrics, além de um cache de respostas e um proxy de imagens.

Recursos principais

  • 01Busca sem API keys e self-hosted, com API JSON compatível com o SearXNG.
  • 02Retorna resultados classificados e o texto extraído das páginas em uma única requisição, para embasar as respostas.
  • 03Consulta cerca de 180 mecanismos em paralelo, com timeouts por mecanismo e backoff.
  • 04Limita as requisições de saída a endereços públicos como proteção contra SSRF.
  • 05Índice local opcional que rastreia seu próprio corpus e classifica resultados com BM25.
  • 06Oferece endpoints de health check e OpenMetrics, além de um cache de respostas.

Casos de uso

  • Oferecer a um agente LLM local buscas na web e texto de fontes que ele pode citar.
  • Manter as consultas de busca dentro da própria rede, em vez de enviá-las a uma API de terceiros.
  • Executar um backend privado de metabusca para scripts ou outras ferramentas.
  • Pesquisar o próprio corpus de documentos junto com resultados da web pública.

Início rápido

  1. 1

    Instale o servidor com Cargo

    cargo install --git https://github.com/sahenjp/RustXNG.git --tag v0.25.0
  2. 2

    Inicie o servidor em 127.0.0.1:8888

    rustxng
  3. 3

    Execute uma busca que retorne JSON

    curl "http://127.0.0.1:8888/search?q=tokio+runtime&format=json"

Antes de usar

  • O Google não está disponível nesta compilação porque os endpoints agora bloqueiam as solicitações ou exigem JavaScript.
  • Para compilar a partir do código-fonte, é necessário usar Rust 1.85 ou posterior.
  • A licença é AGPL-3.0-or-later. Portanto, se você executar uma versão modificada como serviço de rede, deverá oferecer o código-fonte aos usuários.

Em coleções

Tópicos

Perguntas frequentes

O que é RustXNG?
Um mecanismo de busca na web self-hosted e sem API keys, feito em Rust, que retorna resultados classificados e o texto das páginas para embasar agentes de IA locais. RustXNG é um serviço de busca na web self-hosted, desenvolvido para agentes de IA. É uma portabilidade do SearXNG para Rust que agrega resultados de vários mecanismos de busca e, em uma única requisição, também pode retornar o texto extraído das páginas mais relevantes. Assim, o agente pode responder com base em fontes, em vez de depender da memória. Não são necessárias API keys nem há cobrança por consulta, e os termos de busca são processados na máquina do usuário.
RustXNG é gratuito? Qual é a licença?
RustXNG é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
RustXNG ainda é mantido?
Manutenção ativa. O último commit de RustXNG foi em 6 de nov. de 2026.
Para que posso usar RustXNG?
Oferecer a um agente LLM local buscas na web e texto de fontes que ele pode citar. Manter as consultas de busca dentro da própria rede, em vez de enviá-las a uma API de terceiros. Executar um backend privado de metabusca para scripts ou outras ferramentas. Pesquisar o próprio corpus de documentos junto com resultados da web pública.
Como instalar RustXNG?
Instale o servidor com Cargo: cargo install --git https://github.com/sahenjp/RustXNG.git --tag v0.25.0 Inicie o servidor em 127.0.0.1:8888: rustxng Execute uma busca que retorne JSON: curl "http://127.0.0.1:8888/search?q=tokio+runtime&format=json"
Onde consigo RustXNG?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/sahenjp/RustXNG

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

Projetos relacionados