cookbook / neo4j
Neo4j
A graph database with a persistent volume, for data an agent should query, not paraphrase.
- database
- graph
Run it
briq_run({
recipe: "neo4j",
params: {
"version": "5",
"size": "small"
},
wait: true
})briq run neo4j
briq ls
briq logs -f <id>
briq rm <id>import { Briq } from '@briq/sdk';
const briq = new Briq(process.env.BRIQ_API_KEY);
const neo4j = await briq.run({
recipe: 'neo4j',
params: {
"version": "5",
"size": "small"
},
});
console.log(neo4j.outputs.NEO4J_BOLT_URL);
// ... when done
await briq.destroy(neo4j.id);Parameters
| Name | Type | Options | Default |
|---|---|---|---|
| version | enum | 5 | "5" |
| size | enum | nano, small, medium, large | "small" |
Outputs
Returned by briq_run once the stack is healthy. Hosts resolve inside your team network; secrets are generated per run.
- NEO4J_BOLT_URL
- bolt://neo4j.<stack>.internal:7687
- NEO4J_HTTP_URL
- http://neo4j.<stack>.internal:7474
- NEO4J_AUTH
- none
What it runs
| Briq | Image | Ports | Size | Volume |
|---|---|---|---|---|
| neo4j | neo4j:5 | 7474, 7687 | small | 10 GB at /data |
When to use it
- The agent's memory is relationships, not paragraphs: which service calls which, which customer hit which bug, which migration depended on which table. A graph database can answer "what's connected to this?" directly; a markdown note can only be re-read and re-summarized.
- You want the agent to write facts as it learns them, in Cypher, and query them back later in the same session or a different one — structured, not prose.
- You are prototyping a recommendation, fraud, or dependency-graph feature and need a real Bolt endpoint, not a mock.
The volume is 10 GB, mounted at /data, so a stopped briq keeps its graph.
Tips
- Auth is disabled. This recipe sets
NEO4J_AUTH=none, the image's own documented value for running without credentials. There is no public endpoint until you callbriq_expose, and when you do, usemode: "token"— never"public"— since anyone with the URL can read and write the graph. - Talk to it over Bolt.
NEO4J_BOLT_URLworks with the officialneo4j-driverin any language, orcypher-shellviabriq_exec. - Browse it visually.
NEO4J_HTTP_URLserves the Neo4j Browser.briq_exposeport 7474 withmode: "token"to hand a human a link into the same graph the agent is writing to. - Seed it from the agent, not a file:
briq_execwithcypher-shelland aCREATE/MERGEstatement per fact, as the agent learns it.