Age Plotter

A modern web UI for querying Neo4j and PostgreSQL AGE graph databases. Built as a lightweight alternative to Neo4j Browser and AGViewer.

Features

• Monaco Editor - VS Code's editor with Cypher syntax highlighting
• Schema-aware completions - autocomplete for node labels, relationship types, and properties
• Graph visualization - interactive Cytoscape.js graphs with multiple layout options
• Dual view modes - switch between table and graph views
• Query history - with favorites and draft auto-save
• Multi-database support - Neo4j (Bolt) and PostgreSQL AGE
• Session isolation - each browser session has independent connections

Requirements

• Python 3.11+
• Node.js 18+
• uv (recommended) or pip

Quick Start

# Install dependencies
npm install
npm run build
uv sync

# Run
uv run python -m age_plotter

Open http://localhost:8100

Docker

# Copy and edit connection config
cp connections.example.json connections.json

# Run with docker-compose
docker-compose up

Configuration

Environment variables:

Variable	Default	Description
AGE_PLOTTER_HOST	127.0.0.1	Host to bind
AGE_PLOTTER_PORT	8100	Port to bind
AGE_PLOTTER_CONNECTIONS	-	Path to JSON file with preconfigured connections

Preconfigured Connections

Create a connections.json file (see connections.example.json):

[
  {
    "name": "Local Neo4j",
    "type": "neo4j",
    "uri": "bolt://localhost:7687",
    "username": "neo4j",
    "password": "password",
    "database": "neo4j"
  },
  {
    "name": "Local AGE",
    "type": "age",
    "host": "localhost",
    "port": 5432,
    "database": "mydb",
    "username": "postgres",
    "password": "password",
    "graph_name": "my_graph"
  }
]

Then:

export AGE_PLOTTER_CONNECTIONS=/path/to/connections.json
uv run python -m age_plotter

Development

# Watch mode for frontend assets
npm run watch:css
npm run watch:js

# Run with auto-reload
uv run python -m age_plotter --reload

License

MIT