Mole: A Deep Research Agent for Your Terminal

Mole is an open-source project for the terminal that functions as a deep research agent. Created by lajosdeme on GitHub, this tool allows users to ask questions and receive answers in real-time from the web or other databases. By combining large language models with a retrieval system, Mole outputs structured data that can be used for scripting and automation.

The release comes with a command-line interface, a lightweight Python library, and example workflows. Demonstrations of Mole show its ability to handle complex API queries, generate code snippets, and summarize lengthy technical documents. This matters for builders because Mole can be invoked from scripts, Makefiles, or n8n nodes without requiring a graphical user interface. Incorporating AI research into pipelines becomes straightforward with Mole.

One of Mole's notable features is its ability to return results in JSON or YAML format, making it easier for downstream services like n8n or Airflow to process the data and trigger tasks such as ticket creation or documentation updates. Additionally, running Mole locally or on a private server reduces latency by eliminating the need for external API calls, which is beneficial for production workflows that require deterministic performance.

Privacy and compliance are also enhanced since Mole can be operated on-prem or within a controlled environment, ensuring that sensitive data remains within the premises and adhering to strict data-handling policies. The repository includes a plugin system, enabling developers to integrate custom knowledge sources such as internal knowledge bases, GitHub repositories, or proprietary APIs. This makes Mole a highly customizable research assistant that can be tailored to specific team needs.

Teams that already utilize workflow engines like n8n can easily incorporate Mole into their stack, allowing them to prototype AI-driven research steps and iterate quickly without having to build a custom AI layer from scratch. Frequently asked questions address concerns such as Mole's compatibility with servers behind corporate firewalls, its support for multi-step reasoning, and how it handles rate limits when querying external APIs.

Mole is designed to be a versatile and efficient tool for researchers and developers alike, streamlining the process of accessing and utilizing information from various sources.