papergraph 1.0.0 → 1.0.2

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.
Files changed (2) hide show
  1. package/README.md +35 -8
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,9 +1,30 @@
1
1
  # 📄 PaperGraph
2
2
 
3
+ [![npm version](https://img.shields.io/npm/v/papergraph?color=cb3837&logo=npm&logoColor=white)](https://www.npmjs.com/package/papergraph)
4
+ [![Node.js](https://img.shields.io/badge/node-%3E%3D20-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
5
+ [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
6
+ [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
7
+
3
8
  **Build interactive research-paper connectivity graphs from any topic.**
4
9
 
5
10
  PaperGraph is a command-line tool that discovers academic papers, traces their citation networks, computes text similarity, runs graph algorithms, and produces explorable visualizations — all from a single command.
6
11
 
12
+ ### 📦 Install
13
+
14
+ ```bash
15
+ npm install -g papergraph
16
+ ```
17
+
18
+ Then run:
19
+
20
+ ```bash
21
+ papergraph build -t "transformer attention" -o graph.db
22
+ papergraph view -i graph.db -o graph.html
23
+ open graph.html
24
+ ```
25
+
26
+ > **No API keys required** — works out of the box with [OpenAlex](https://openalex.org/) (free, open academic data).
27
+
7
28
  ---
8
29
 
9
30
  ## ✨ Motivation
@@ -208,19 +229,25 @@ Paper-Graph/
208
229
 
209
230
  ## 🚀 Quick Start
210
231
 
232
+ ### Global Install (recommended)
233
+
211
234
  ```bash
212
- # Install dependencies
213
- npm install
235
+ npm install -g papergraph
236
+ papergraph build -t "neural speech enhancement" -d 2 -m 100 -o graph.db
237
+ papergraph view -i graph.db -o graph.html
238
+ ```
214
239
 
215
- # Build
216
- npm run build
240
+ ### From Source
217
241
 
218
- # Run
219
- npx papergraph build -t "transformer attention" -o graph.db
220
- npx papergraph view -i graph.db
242
+ ```bash
243
+ git clone https://github.com/DashankaNadeeshanDeSilva/Paper-Graph.git
244
+ cd Paper-Graph
245
+ npm install
246
+ npm run build
247
+ node dist/index.js build -t "transformer attention" -o graph.db
221
248
  ```
222
249
 
223
- See [USAGE.md](./USAGE.md) for detailed usage instructions.
250
+ See **[USAGE.md](./USAGE.md)** for full CLI reference, configuration options, and workflow examples.
224
251
 
225
252
  ---
226
253
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "papergraph",
3
- "version": "1.0.0",
3
+ "version": "1.0.2",
4
4
  "description": "CLI tool that creates research-paper connectivity graphs from topics, keywords, or paper titles. Produces SQLite DB + self-contained HTML visualization.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -60,4 +60,4 @@
60
60
  "typescript": "^5.7.3",
61
61
  "vitest": "^3.0.5"
62
62
  }
63
- }
63
+ }