Connection Not connected

HBDS Help

What Is HBDS Graphic Simulator

An interactive browser-based simulator for Hypergraph-Based Data Structures (HBDS). The app renders HBDS models as editable 2D diagrams and optional 3D scenes using Three.js.

User Guide

Open And Navigate

  • Use Models for read-only exploration, Edit for files saved under models/, and Tests for regression files saved under test_models/.
  • Select a model from the model list, then use Fit Model, zoom, pan, the 2D/3D toggle, and the overview to inspect it.
  • Use the model tree to find classes, hyperclasses, attributes, and links by name or ID.

Edit Models

  • In Edit or Tests, create and update hyperclasses, classes, attributes, and links from the left-side controls.
  • Drag class and hyperclass nodes on the canvas, use layout controls to organize the diagram, and use route presets for selected links.
  • Use the selected link property panel to choose arrow type, arrow direction, line style, line width, line color, arrow color, and label size. Supported arrows include filled, outline, chevrons, dotted, bar-arrow, cone, diamond, bidirectional, and plain association styles.
  • Use Settings > Font for the overall model font size, then override class, hyperclass, attribute, or link label sizes separately. Apply Overall Font To All clears category and element font-size overrides.
  • Use Save to persist the current model, or Delete Model to remove the selected saved file after confirmation. Deleted models are backed up under the matching .backups directory.

Collaboration

  • When the local server is connected, other browser tabs on the same model appear in Live Collaboration.
  • Review remote changes before saving. Use Merge Both for safe non-conflicting edits, Use Theirs to accept the selected remote draft, or Keep Mine to keep your local version.

AI Support

  • Open AI Support in Edit or Tests to generate a new HBDS model, validate the current model, or improve the current model.
  • Select ChatGPT/OpenAI, Claude/Anthropic, Local/Ollama, Custom OpenAI-compatible, or ChatGPT Pro / Manual. API keys entered in the UI are held in memory only and are not saved into model JSON.
  • ChatGPT Pro / Manual prepares a precise HBDS prompt for copy/paste into ChatGPT, then lets you paste the JSON response back for validation.
  • Valid AI responses must be plain JSON with metadata, hypergraph.class, hypergraph.link, valid IDs, valid link references, and usable positions.
  • Apply AI Result opens the AI Changes Preview window. Preview on Canvas shows a temporary grid-arranged preview, Apply and Save updates the current file when validating or improving, and Apply as New Model creates a new file.
  • Rollback AI Apply restores the previous saved model after same-file changes, or deletes the newly-created AI model after Apply as New Model.
Keyboard Shortcuts
  • F Fit the current model
  • V Toggle 2D/3D view where available
  • Esc Close help
Why HBDS

HBDS means Hypergraph-Based Data Structure.

It is a data modeling and knowledge representation method created by François Bouillé, mainly developed in France around the 1980s-1990s for advanced information systems, GIS, scientific databases, and complex semantic structures.

GitHub

Project repository: https://github.com/arcazj/openbexi_hbds

Swagger API

The local Python server exposes model load/save endpoints and an OpenAPI specification.

  • OpenAPI specification
  • API documentation