@lincoln504/pi-research 1.3.6 → 1.3.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +27 -37
- package/docs/CHANGELOG.md +9 -0
- package/package.json +9 -5
- package/skills/pi-research/SKILL.md +1 -1
package/README.md
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<img src="https://raw.githubusercontent.com/Lincoln504/pi-research/main/docs/media/banner.jpg" alt="pi-research" width="100%" />
|
|
2
|
+
<img src="https://raw.githubusercontent.com/Lincoln504/pi-research/main/docs/media/banner.jpg" alt="pi-research — free, unlimited web search and deep research for coding agents" width="100%" />
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
5
|
<p align="center">
|
|
6
|
-
<strong>
|
|
6
|
+
<strong>Free, unlimited web search & deep research for coding agents — no API key, no quota</strong>
|
|
7
7
|
</p>
|
|
8
8
|
|
|
9
9
|
<p align="center">
|
|
@@ -24,60 +24,50 @@
|
|
|
24
24
|
|
|
25
25
|
<a href="https://github.com/Lincoln504/pi-research/actions/workflows/ci.yml"><img alt="Build status" src="https://img.shields.io/github/actions/workflow/status/Lincoln504/pi-research/ci.yml?style=flat-square&branch=main" /></a> <a href="https://www.npmjs.com/package/@lincoln504/pi-research"><img alt="npm version" src="https://img.shields.io/npm/v/@lincoln504/pi-research.svg?style=flat-square" /></a>
|
|
26
26
|
|
|
27
|
-
|
|
27
|
+
Search and scraping run locally through a stealth browser — no search provider, no monthly cap. You pay only for the LLM tokens you use.
|
|
28
|
+
|
|
29
|
+
### Install
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
pi install npm:@lincoln504/pi-research
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
In [pi](https://github.com/earendil-works/pi) it works out of the box, on your session's model and pi's configuration. Standalone use — [agent skill](docs/AGENT-SKILL.md), CLI, or [SDK](docs/SDK.md) — needs a model configured; see [Configuration](docs/CONFIGURATION.md). The first install pulls the stealth browser engine, which takes a few minutes.
|
|
28
36
|
|
|
29
37
|
### How it works
|
|
30
38
|
|
|
31
|
-
A research run loops through agent teams: a coordinator plans and opens with a search, researcher agents scrape and read in parallel, and an evaluator decides whether to go another round or synthesize
|
|
39
|
+
A research run loops through agent teams: a coordinator plans and opens with a search, researcher agents scrape and read in parallel, and an evaluator decides whether to go another round or synthesize. The result is one cited Markdown report, with findings optionally saved to the knowledge store.
|
|
32
40
|
|
|
33
|
-
Three depth levels — normal, deep, ultra — set the team size and number of rounds
|
|
41
|
+
Three depth levels — normal, deep, ultra — set the team size and number of rounds. Ask in natural language and the tool picks the right one:
|
|
34
42
|
|
|
35
43
|
|
|
36
44
|
|
|
37
45
|
### Use cases
|
|
38
46
|
|
|
39
47
|
- Researching for your [Pi](https://github.com/earendil-works/pi) Coding Agent — plug-and-play, no API key needed.
|
|
40
|
-
- Researching from Claude Code, Codex, or another coding agent, with a cheaper
|
|
41
|
-
-
|
|
42
|
-
-
|
|
43
|
-
- Using the pi-research agent skill as OpenClaw's web access.
|
|
44
|
-
- Building agent systems that find and read web content.
|
|
48
|
+
- Researching from Claude Code, Codex, OpenClaw, or another coding agent, with a cheaper or local model driving the run so it doesn't spend your main agent's budget.
|
|
49
|
+
- Keeping a persistent, searchable knowledge store of findings — global or per-project.
|
|
50
|
+
- Building agent systems that find and read web content, or populating a dataset of web sources.
|
|
45
51
|
|
|
46
52
|
### Why pi-research
|
|
47
53
|
|
|
48
|
-
- **
|
|
49
|
-
- **You own your index.** Every finding is written
|
|
50
|
-
- **Cited reports, not raw dumps.**
|
|
51
|
-
- **Read-only by design.**
|
|
52
|
-
- **Search a little or a lot
|
|
54
|
+
- **No quota, no monthly fee.** Most AI-search providers cap free searches and then charge, with results served from *their* index on *their* servers. pi-research searches and scrapes locally — DuckDuckGo via a stealth browser.
|
|
55
|
+
- **You own your index.** Every finding is written to a local [LanceDB](https://lancedb.com) knowledge store that seeds future runs, so repeat questions get faster, cheaper answers.
|
|
56
|
+
- **Cited reports, not raw dumps.** One synthesized, sourced Markdown report instead of raw web content pasted into the conversation — context-efficient and easy to verify.
|
|
57
|
+
- **Read-only by design.** The research agent cannot run shell commands or write, edit, or delete anything. It can read and search files, so treat it as you would any read-only agent with access to your machine.
|
|
58
|
+
- **Search a little or a lot.** Depth levels span a quick pass to a large-scale investigation.
|
|
53
59
|
|
|
54
60
|
### Requirements / limitations
|
|
55
61
|
|
|
56
62
|
- Node.js >= 22.19.0
|
|
57
|
-
- An LLM with a 100k+ context window
|
|
58
|
-
- Internet access
|
|
59
|
-
-
|
|
60
|
-
-
|
|
61
|
-
- Cloudflare and similar anti-automation systems block scraping on some sites, so a run will flag pages it can't reach. pi-research compensates with volume: the search tool pulls a large set of results off free DuckDuckGo, giving the model a wide selection of reachable content to cite.
|
|
62
|
-
|
|
63
|
-
### Install
|
|
64
|
-
|
|
65
|
-
```bash
|
|
66
|
-
pi install npm:@lincoln504/pi-research
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
See [Agent skill](docs/AGENT-SKILL.md) or [SDK](docs/SDK.md) to install standalone (no pi extension).
|
|
70
|
-
|
|
71
|
-
The pi extension works out of the box — it runs on your pi session's model and pi's own configuration. To use it standalone (agent skill / CLI), configure a model: set `PI_RESEARCH_MODEL` (e.g. `openai/gpt-4o`) as an environment variable or in `~/.pi/research/config.env` (the CLI also accepts a per-run `--model`), plus `PI_RESEARCH_API_KEY` if you don't use pi; the SDK takes a `model` option. See [Configuration](docs/CONFIGURATION.md).
|
|
72
|
-
|
|
73
|
-
The first install pulls the stealth browser engine, which takes a few minutes.
|
|
74
|
-
|
|
75
|
-
### Stability (v1.x.x)
|
|
63
|
+
- An LLM with a 100k+ context window — bring your own key or use a local model
|
|
64
|
+
- Internet access on a residential IP — search, scraping, and YouTube transcripts rely on a residential connection; a datacenter/VPS/cloud IP gets bot-blocked
|
|
65
|
+
- The [pi runtime](https://github.com/earendil-works/pi) — the pi extension uses the host's copy; the standalone CLI and agent skill install it as a dependency
|
|
66
|
+
- Cloudflare and similar systems block scraping on some sites — a run flags pages it can't reach and compensates with a wide pool of search results to cite
|
|
76
67
|
|
|
77
|
-
|
|
68
|
+
### Channels
|
|
78
69
|
|
|
79
|
-
|
|
80
|
-
- A git install is the development channel: latest commits, first to break.
|
|
70
|
+
npm (`npm:@lincoln504/pi-research`) is the stable channel, kept current with breaking pi changes. A git install is the development channel: latest commits, first to break.
|
|
81
71
|
|
|
82
72
|
### License
|
|
83
73
|
|
package/docs/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,15 @@ All notable changes to this project will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [1.3.7] - 2026-08-11
|
|
9
|
+
|
|
10
|
+
Discovery and packaging metadata only — no engine changes.
|
|
11
|
+
|
|
12
|
+
### Changed
|
|
13
|
+
|
|
14
|
+
- **README rewritten for concision and effectiveness.** The pitch ("free, unlimited web search & deep research for coding agents — no API key, no quota") now leads the page, install moved up to directly under the badges, each claim is stated once, and detail that only matters after adoption moved to `docs/`. 88 → 78 lines.
|
|
15
|
+
- **npm description and keywords rewritten.** The description is now benefit-led and survives catalog truncation; keywords gained `pi-coding-agent`, `web-research`, `deep-research`, `knowledge-store`, `duckduckgo`, and `skills`, and dropped `security` and `stack-exchange`.
|
|
16
|
+
|
|
8
17
|
## [1.3.6] - 2026-08-10
|
|
9
18
|
|
|
10
19
|
An independent fresh-eyes review of the entire 1.3.4→1.3.5 diff — the previous
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lincoln504/pi-research",
|
|
3
|
-
"version": "1.3.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "1.3.7",
|
|
4
|
+
"description": "Free, unlimited web search and deep research for the Pi coding agent — no search API key, no quotas. Local knowledge store; also works from Claude Code, Codex, and OpenClaw.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"private": false,
|
|
7
7
|
"main": "./src/index.ts",
|
|
@@ -52,16 +52,20 @@
|
|
|
52
52
|
"pi",
|
|
53
53
|
"pi-package",
|
|
54
54
|
"pi-extension",
|
|
55
|
+
"pi-coding-agent",
|
|
55
56
|
"openclaw",
|
|
56
57
|
"agent-skill",
|
|
58
|
+
"skills",
|
|
57
59
|
"research",
|
|
60
|
+
"web-research",
|
|
61
|
+
"deep-research",
|
|
58
62
|
"agent",
|
|
59
63
|
"web-search",
|
|
60
64
|
"scraping",
|
|
65
|
+
"knowledge-store",
|
|
66
|
+
"duckduckgo",
|
|
61
67
|
"stealth-browser",
|
|
62
|
-
"camoufox"
|
|
63
|
-
"security",
|
|
64
|
-
"stack-exchange"
|
|
68
|
+
"camoufox"
|
|
65
69
|
],
|
|
66
70
|
"author": "Lincoln Deen",
|
|
67
71
|
"contributors": [
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: pi-research
|
|
3
3
|
description: "Multi-agent web research for any coding agent. Use for anything requiring current information from the internet — news, trends, product/service/company facts, statistics, people, places, events, APIs, library behavior, or 'what is X / how does X work' questions. Also use to search a local knowledge store of previously researched findings before doing live research. Powered by the pi-research engine (search, stealth scraping, security databases, Stack Exchange). Not for reading local files, running project commands, or analyzing this repository's own source."
|
|
4
4
|
license: MIT
|
|
5
|
-
metadata: { "author": "Lincoln Deen", "version": "1.3.
|
|
5
|
+
metadata: { "author": "Lincoln Deen", "version": "1.3.7", "package": "@lincoln504/pi-research", "engine": "pi-research-sdk", "openclaw": { "requires": { "bins": ["node"] } } }
|
|
6
6
|
allowed-tools: Bash(node:*)
|
|
7
7
|
---
|
|
8
8
|
|