@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 CHANGED
@@ -1,128 +1,12 @@
1
1
  # IronGraph
2
2
 
3
- **A CPU graph database with built-in streaming and queues.**
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 installs, verifies, loads, and warms the local embedding
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: