Subgraph Studio

Desktop GUI for introspecting GraphQL schemas and building VANTAGE query configurations.

Features

• Discover subgraph endpoint names from .env files using AES keyring service
• Supply subgraph URLs manually
• Introspect live GraphQL schemas
• Browse query roots and fields
• Build GraphQL queries with field selection
• Preview live responses
• Export VANTAGE-style protocol JSON configuration files

Installation

From source (pip)

cd subgraph_studio
pip install .

Run directly

python -m subgraph_studio

As a CLI command (after pip install)

subgraph-studio

Docker

Build

docker build -t subgraph-studio .

Run (with X11 forwarding for GUI)

# Linux
xhost +local:docker
docker run -it --rm \
  -e DISPLAY=$DISPLAY \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -v $HOME/.Xauthority:/root/.Xauthority:ro \
  -v $(pwd):/data \
  --network host \
  subgraph-studio

Dependencies

• Python 3.10+
• requests - HTTP client for GraphQL requests
• keyring - Secure credential storage
• tkinter - GUI framework (usually included with Python; install python3-tk on Debian/Ubuntu)

Development

pip install -e ".[dev]"

Project Structure

subgraph_studio/
├── pyproject.toml          # Package configuration
├── requirements.txt        # Python dependencies
├── Dockerfile              # Container definition
├── .dockerignore           # Docker build exclusions
└── subgraph_studio/        # Python package
    ├── __init__.py         # Package exports
    ├── __main__.py         # Entry point (python -m subgraph_studio)
    ├── app.py              # Main SubgraphStudio GUI class
    ├── constants.py        # Constants and introspection query
    ├── schema.py           # GraphQL schema data models
    ├── query.py            # Query builder
    ├── utils.py            # Utility functions
    └── widgets.py          # Custom Tkinter widgets