@irongraph/cli-darwin-arm64 0.1.7 → 0.1.9
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 +2 -118
- package/THIRD_PARTY_NOTICES.txt +631 -1622
- package/bin/irongraph +2 -2
- package/bin/irongraph-mcp +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,128 +1,12 @@
|
|
|
1
1
|
# IronGraph
|
|
2
2
|
|
|
3
|
-
**
|
|
3
|
+
**Embeddable Cypher graph database with sub-µs point reads, built-in streams, queues, and local text embeddings. Standalone launcher.**
|
|
4
4
|
|
|
5
5
|
Use Cypher to query graph structure, search text and vectors, inspect property history, and
|
|
6
6
|
administer the database. Built-in Kafka-compatible Streams and AMQP-compatible Queues handle event
|
|
7
7
|
and message workloads. The `irongraph` CLI starts and manages a standalone database with its
|
|
8
8
|
built-in web console. IronGraph is open-source software released under the Apache License 2.0.
|
|
9
9
|
|
|
10
|
-
## Performance at a glance
|
|
11
|
-
|
|
12
|
-
Graph queries execute on the CPU against one shared canonical graph. Local text inference can
|
|
13
|
-
use Metal or CUDA independently. Measure complete queries separately from individual graph operations;
|
|
14
|
-
latency depends on the workload, graph size, indexes, and host.
|
|
15
|
-
|
|
16
|
-
## Start the database and open the web console
|
|
17
|
-
|
|
18
|
-
Use this path to run IronGraph as a standalone database with its built-in web console.
|
|
19
|
-
Python, Node.js, and Rust embedding are separate options described below.
|
|
20
|
-
|
|
21
|
-
### 1. Check the prerequisites
|
|
22
|
-
|
|
23
|
-
You need Node.js 20.17 or later with npm, and an official `irongraph` release available on npm
|
|
24
|
-
for your platform: macOS 15+ ARM64, or Linux ARM64/AMD64 with glibc 2.28+. Before the first
|
|
25
|
-
official publication, these npm commands are not an available installation channel.
|
|
26
|
-
|
|
27
|
-
Use a writable local data directory owned exclusively by this database process. First startup
|
|
28
|
-
also needs network access and several gigabytes of free storage for the automatically installed
|
|
29
|
-
local text embedding model. The launcher selects a compiled database binary with the web console
|
|
30
|
-
included. You do not need Python, a Rust compiler, or a separate frontend server.
|
|
31
|
-
|
|
32
|
-
### 2. Start IronGraph
|
|
33
|
-
|
|
34
|
-
Run this command to install the matching package as needed and start in the background:
|
|
35
|
-
|
|
36
|
-
```sh
|
|
37
|
-
npx irongraph start --background
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
Your data lives in `~/.irongraph/data`. The database keeps running after you close the terminal.
|
|
41
|
-
Wait for startup and the embedding model's installation, loading, and warm-up to finish. Check
|
|
42
|
-
progress and readiness with:
|
|
43
|
-
|
|
44
|
-
```sh
|
|
45
|
-
npx irongraph logs
|
|
46
|
-
npx irongraph status
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
Graph execution uses the CPU. Text inference selects its device independently; on a supported
|
|
50
|
-
Mac, use `--embedding-backend metal`. On CPU-only hosts, including the published Linux packages,
|
|
51
|
-
start with `npx irongraph start --background --embedding-backend cpu`. Automatic inference selection
|
|
52
|
-
requires a supported accelerator. To run in the
|
|
53
|
-
foreground with live terminal output, use `npx irongraph start` without `--background`.
|
|
54
|
-
|
|
55
|
-
### 3. Open the web console
|
|
56
|
-
|
|
57
|
-
When status reports **ready**, open **[http://127.0.0.1:18484/web/](http://127.0.0.1:18484/web/)**
|
|
58
|
-
in a browser on the same computer.
|
|
59
|
-
This address belongs to your running local instance. The product website at
|
|
60
|
-
The public project page is not your database console.
|
|
61
|
-
|
|
62
|
-
The console provides Query, Streams, Documents (for text documents), Training, Docs, and
|
|
63
|
-
Settings. The graph visualization is the Plot result view inside Query.
|
|
64
|
-
|
|
65
|
-
### 4. Create your first project
|
|
66
|
-
|
|
67
|
-
Click **New** in the top bar, enter `notes`, and click **Create project**. The console selects
|
|
68
|
-
your new project. In **Query**, replace the editor contents with:
|
|
69
|
-
|
|
70
|
-
```cypher
|
|
71
|
-
USE notes
|
|
72
|
-
RETURN 'IronGraph is ready' AS status
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
Click **Run**, then select the **Table** result view. Expected result: a `status` column
|
|
76
|
-
containing `IronGraph is ready`. Every graph operation needs
|
|
77
|
-
an explicit project; IronGraph has no implicit default project. Next, open **Documents** to work
|
|
78
|
-
with text documents in your project, or continue in Query to create nodes and relationships.
|
|
79
|
-
|
|
80
|
-
### 5. Stop and restart
|
|
81
|
-
|
|
82
|
-
For a background instance, run:
|
|
83
|
-
|
|
84
|
-
```sh
|
|
85
|
-
npx irongraph stop
|
|
86
|
-
```
|
|
87
|
-
|
|
88
|
-
For a foreground instance, press `Ctrl+C` and wait for the process to exit. Start again with
|
|
89
|
-
`npx irongraph start --background` to reopen the same data directory. Your data persists between
|
|
90
|
-
runs. Background mode does not install a system service or restart the database after a reboot.
|
|
91
|
-
|
|
92
|
-
### Configuration and direct binary use
|
|
93
|
-
|
|
94
|
-
Choose another directory with `--data-dir /absolute/path`. Pass the same directory to `status`,
|
|
95
|
-
`logs`, and `stop`. A second start cannot open a second managed instance on that directory.
|
|
96
|
-
|
|
97
|
-
Local listener defaults are consistent across development and releases:
|
|
98
|
-
|
|
99
|
-
| Surface | Loopback port |
|
|
100
|
-
| --- | --- |
|
|
101
|
-
| Web console and Query API | `18484` |
|
|
102
|
-
| Bolt | `18485` |
|
|
103
|
-
| Kafka-compatible Streams | `18486` |
|
|
104
|
-
| AMQP-compatible Queues | `18487` |
|
|
105
|
-
| Local MCP HTTP | `18488` |
|
|
106
|
-
|
|
107
|
-
The frontend development server uses `18489`; the standalone console is always served by the
|
|
108
|
-
database's HTTP listener. Embedded libraries do not start these listeners.
|
|
109
|
-
|
|
110
|
-
If the console does not open, check that the process is still running and startup completed.
|
|
111
|
-
If port `18484` is already occupied, start with `--http-addr 127.0.0.1:19484` and open
|
|
112
|
-
`http://127.0.0.1:19484/web/` instead. Keep plain listeners on loopback; access from another
|
|
113
|
-
computer requires a configured remote listener with mutual TLS.
|
|
114
|
-
|
|
115
|
-
You can also extract the matching official standalone archive and run its executable directly,
|
|
116
|
-
without Node.js or npm:
|
|
117
|
-
|
|
118
|
-
```sh
|
|
119
|
-
./bin/irongraph --data-dir "$HOME/.irongraph/data" --http-addr 127.0.0.1:18484
|
|
120
|
-
```
|
|
121
|
-
|
|
122
|
-
Direct execution runs in the foreground. Stop it with `Ctrl+C`; launcher commands manage only
|
|
123
|
-
instances started through the launcher. The archive also includes `bin/irongraph-mcp` for local
|
|
124
|
-
stdio MCP hosts.
|
|
125
|
-
|
|
126
10
|
## Database capabilities
|
|
127
11
|
|
|
128
12
|
| Capability | What you can do |
|
|
@@ -178,7 +62,7 @@ your release. CUDA requires a package built with CUDA support.
|
|
|
178
62
|
## Start with a text document in Python
|
|
179
63
|
|
|
180
64
|
You need Python 3.9 or later, a matching official wheel, and a writable directory owned by one
|
|
181
|
-
application process. Default startup
|
|
65
|
+
application process. Default startup downloads, loads, and warms the local Bekko a8m embedding
|
|
182
66
|
model; allow network access and space for the model on first use.
|
|
183
67
|
|
|
184
68
|
After configuring your official package source, install the binary package:
|