OrioSearch: Your AI Agent need WebSearch
vkfolio · Programação
O OrioSearch é uma API de busca na web e extração de conteúdo de código aberto e auto-hospedada, feita para agentes de IA. Ele imita a interface do Tavily. Você troca uma URL e seu código continua funcionando. E o detalhe? Você mesmo hospeda e não paga nada por consulta. Essa é a troca. Ele reúne SearXNG, FastAPI e Redis em uma única implantação Docker que você controla, então sua busca roda onde você decidir colocá-la.

Sobre OrioSearch: Your AI Agent need WebSearch
O que é o OrioSearch
O OrioSearch é um backend de busca que você executa na sua própria máquina ou servidor. Ele responde às mesmas chamadas /search e /extract que o Tavily, puxa resultados de uma camada de metabusca do SearXNG e também pode devolver o texto limpo de uma página ou respostas escritas por IA. A proposta é simples: seus agentes têm busca na web sem cobrança medida e sem enviar cada consulta pelos servidores de outra pessoa.
O projeto é voltado a desenvolvedores que criam agentes de IA, pipelines de RAG ou ferramentas de pesquisa e não querem que o custo por consulta cresça com o uso. Tudo é publicado sob a licença MIT, então você pode ler o código, modificá-lo e implantá-lo comercialmente. Essa liberdade é rara. A maioria das APIs de busca hospedadas mantém o interior fechado, e você aceita o preço que elas definem, que costuma subir conforme seu uso cresce e deixa você com pouca margem quando os termos mudam.
O principal porém é que agora a hospedagem é problema seu. Você precisa de Docker, de um lugar para rodar três serviços e de alguém que cuide das atualizações e das quedas. Se um motor de busca sai do ar, isso é da sua infraestrutura, não do suporte de um fornecedor. A equipe não oferece uma opção de nuvem gerenciada, então você troca conveniência por controle. Aviso justo. Quem deveria passar longe? Quem não tem um servidor onde rodar.
Primeiros passos
- Instale o Docker e o Docker Compose na máquina que vai hospedar o serviço.
- Clone o repositório do GitHub e rode
docker compose up --buildpara iniciar a API, o SearXNG e o Redis de uma vez. - Confirme que a API está ativa com uma requisição a
/health, que deve retornar um status ok. - Envie uma chamada de teste
POST /searchcom uma consulta emax_results, e confirme que você recebe títulos, URLs e trechos. - Aponte o código do Tavily que você já usa no seu agente para
http://localhost:8000e remova a chave de API.
Informações do produto
Uma visão rápida dos preços, das plataformas compatíveis e do desempenho de OrioSearch: Your AI Agent need WebSearch.
Ideal para
Os usuários, tarefas e cenários em que esta ferramenta se encaixa melhor.
Usuários
- Desenvolvedores de agentes de IA
- Criadores amadores e indies
- Equipes com regras de privacidade de dados
Tarefas
- Busca na web para agentes de IA
- Extração de conteúdo
- Geração de respostas com IA
Cenários
- Trabalhos de pesquisa longos que disparam centenas de consultas
- Pipelines sensíveis à privacidade
- Pilhas de agentes auto-hospedadas
Principais recursos
Substituto direto compatível com Tavily
A API espelha os endpoints /search, /extract e /tool-schema do Tavily, então migrar costuma significar trocar uma URL base e apagar a chave de API. O código do seu agente e a leitura das respostas continuam funcionando. Essa compatibilidade é o motivo de a migração não doer, porque uma troca normal de API exige reescrever montadores de requisição, tratadores de resposta e rotas de erro antes de publicar qualquer coisa. Sem reescritas. Também não há SDK novo para aprender.
Mais de 70 motores de busca via SearXNG
O OrioSearch se apoia no SearXNG para reunir resultados do Google, Bing, DuckDuckGo e dezenas de outros, com fallback automático para o DuckDuckGo se o SearXNG estiver inacessível. Mais fontes significam mais chance de capturar um resultado que um único motor deixaria passar. Qual motor vence depende da consulta, e é justamente esse o sentido de juntá-los.
Extração de conteúdo em camadas
Quando você aponta para uma URL, o pipeline de extração usa primeiro o trafilatura e recorre ao readability-lxml se ele falhar. Devolve markdown limpo ou texto puro em vez de HTML bruto. Isso economiza uma etapa de parsing antes de o conteúdo entrar em um modelo. Coisa pequena. Soma muito ao longo de milhares de páginas.
Respostas de IA com citações
Ligue include_answer: true e o OrioSearch sintetiza uma resposta a partir dos resultados obtidos usando um modelo compatível com OpenAI, e depois anexa as fontes. Você pode rodá-lo com Ollama localmente ou direcioná-lo para OpenAI ou Groq se preferir um modelo hospedado. Você escolhe. A qualidade da resposta acompanha o modelo que você conectar, então um modelo local pequeno e um de ponta não soam iguais.
Resultados em streaming com SSE
O endpoint /search/stream envia os resultados por Server-Sent Events conforme chegam, em vez de esperar a resposta completa. Para agentes que agem no primeiro resultado útil, isso corta tempo real em cada turno. Não é ganho pequeno quando seu agente dispara dezenas de buscas por tarefa.
Cache e reordenação com Redis
O Redis agrupa as consultas com TTL configuráveis e fallback elegante para cache expirado, então buscas repetidas voltam rápido. Além disso, um pequeno modelo FlashRank ONNX reordena os resultados por relevância semântica, tudo em CPU e sem dependência de PyTorch. Não precisa de GPU. Isso mantém o consumo pequeno o bastante para rodar ao lado do seu app em uma máquina modesta.
Prós e contras
Prós
- Custo zero por consulta, então uso pesado do agente não vira uma fatura crescente.
- A compatibilidade direta com o Tavily reduz a migração a uma troca de URL de uma linha.
- As consultas e os dados ficam na sua própria infraestrutura, o que importa em trabalhos sensíveis à privacidade.
- A licença MIT deixa você inspecionar, modificar e usar o código comercialmente sem amarras.
Contras
- Hospedagem, atualizações e quedas ficam com você, e não há fallback de nuvem gerenciada se sua máquina cair em um momento ruim.
- A configuração exige familiaridade com Docker e um pouco de know-how de operações, o que afasta usuários não técnicos.
- As respostas de IA dependem de um LLM separado que você fornece, então é mais uma peça para configurar e pagar.
- Não há app móvel oficial nem loja de plugins, então tudo passa pela API.
Perguntas frequentes
Sim. É código aberto sob a licença MIT e não custa nada por consulta, por mais que seus agentes busquem. Seus únicos custos são o que você paga para rodar o host Docker.
Conteúdo relacionado
Explore ferramentas, skills e artigos relacionados a OrioSearch: Your AI Agent need WebSearch.
Alternativas a OrioSearch: Your AI Agent need WebSearch
Forefront
Forefront · ProgramaçãoO Forefront é uma plataforma web para construir com IA de código aberto. Você ajusta os principais modelos de linguagem de código aberto com seus próprios dados, avalia o desempenho deles e os roda por uma API ou os exporta para hospedar por conta própria. Desenvolvedores que querem a conveniência de uma plataforma fechada, mas fazem questão de ser donos dos modelos e dos dados, são o público-alvo aqui.
Startkit
StartKit.AI · ProgramaçãoStartkit é um boilerplate para criar produtos de SaaS com IA e wrappers de IA. Pense nele como um boilerplate para startups de IA com as partes chatas já conectadas: autenticação, pagamentos com Stripe e Lemon Squeezy, limites de uso, e-mail transacional e um kit inicial de API de IA que conversa com OpenAI, Anthropic, Groq ou Llama. Você clona o repositório, define seu preço e começa pela parte do produto que as pessoas realmente pagam. Ele é feito em Next.js sobre React e Tailwind, então boa parte do código boilerplate já parece familiar.
Testim
Tricentis · ProgramaçãoO Testim é uma plataforma de automação de testes com IA para criar e executar testes de ponta a ponta em aplicações web, mobile e Salesforce. Ele se apoia no aprendizado de máquina para manter os testes estáveis quando uma interface muda, então as equipes gastam menos tempo consertando seletores quebrados. Nada mal para uma ferramenta de testes automatizados que você pode começar a usar hoje. Você cria testes gravando ações no navegador e depois adiciona JavaScript quando precisa de mais controle. É uma escolha sólida para equipes de QA ocupadas.
