Who it is forA developer or analyst who needs a multi-step research answer and is willing to install a Python tool.
The problemDoing multi-step research by hand across many sources takes time, and a single chat prompt rarely covers it.
The outcomeA running Poirot session that answers a research question in the TUI conversation view.
What you need first
- Python 3.12 or newer
- A DeepSeek API key (the README says to set DEEPSEEK_API_KEY in .env)
- Git and a terminal
- Docker only if you want the container sandbox
Steps
- Clone the repo from https://github.com/HezaoHezao/poirot and change into the project folder. (inferred, check the README)
- Create a virtual environment with
python -m venv .venv. - Activate it with
source .venv/bin/activateon Linux or macOS, or.venv\Scripts\activateon Windows. - Install the project with
pip install -e ".[dev]". - Copy the sample config with
cp .env.example .envand set DEEPSEEK_API_KEY in .env. - Start Poirot with
poirotand type your research question.
Prompt for your agent
Using the Poirot repo at <path to poirot checkout>, create a virtual environment, install it, set DEEPSEEK_API_KEY in .env, and launch `poirot` with the research question <research question>. Expected output: a research answer shown in the TUI conversation view. Verify that the status bar shows live token usage.
Caveat. The README says the default launch is the TUI and points to USAGE.md for full configuration and troubleshooting, so check that file if setup fails.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for HezaoHezao/poirot and "Run a deep research session from the terminal"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer