← Index

io.github.TheAiSingularity/agentic-research

io.github.TheAiSingularity/agentic-research·v0.1.3·Search
Quality Score
80
/100

Local research agent that verifies its own answers. Runs on Gemma 3 4B + Ollama, $0/query.

§01  Install
Claude Desktop (uvx)
{
  "mcpServers": {
    "agentic-research": {
      "command": "uvx",
      "args": [
        "agentic-research-engine"
      ],
      "env": {
        "OPENAI_BASE_URL": "<openai_base_url>",
        "OPENAI_API_KEY": "<your-openai_api_key>",
        "MODEL_SYNTHESIZER": "<model_synthesizer>",
        "MODEL_PLANNER": "<model_planner>",
        "EMBED_MODEL": "<embed_model>",
        "SEARXNG_URL": "<searxng_url>",
        "LOCAL_CORPUS_PATH": "<local_corpus_path>",
        "ENABLE_RERANK": "<enable_rerank>",
        "ENABLE_FETCH": "<enable_fetch>"
      }
    }
  }
}
§02  Environment variables
OPENAI_BASE_URL

Any OpenAI-compatible endpoint. Default: OpenAI cloud. Use http://localhost:11434/v1 for Ollama.

OPENAI_API_KEY
secret

API key for the endpoint above. Use 'ollama' as a sentinel value when running locally against Ollama.

MODEL_SYNTHESIZER

Model identifier used for the synthesize node. Defaults to 'gpt-5-mini'; set to 'gemma3:4b' for Mac-local Ollama.

MODEL_PLANNER

Model for the plan / classify / critic / compress / verify nodes. Defaults to 'gpt-5-nano'.

EMBED_MODEL

Embedding model identifier (for retrieval + memory). Default 'text-embedding-3-small'; use 'nomic-embed-text' on Ollama.

SEARXNG_URL

Base URL of the SearXNG meta-search instance. Default http://localhost:8888.

LOCAL_CORPUS_PATH

Path to an index directory built via scripts/index_corpus.py. When set, local corpus hits augment web search.

ENABLE_RERANK

Set to '1' to enable the BAAI/bge-reranker-v2-m3 cross-encoder rerank stage. First run downloads ~560MB.

ENABLE_FETCH

Set to '0' to skip the trafilatura full-page fetch stage. Default '1'.

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
10
installability
25
documentation
15
stability
5
§04  Alternatives in Search