AtomSpace Visualizer

A web-based visualization tool for AtomSpace contents. Provides statistics and the ability to visualize structures held in the AtomSpace. Meant to be an aid in understanding AtomSpace contents.

Try it here. You must have a CogServer running somewhere; you will need to type the URL into the connection box.

Prerequisites

This visualizer connects to a running CogServer to get at the AtomSpace contents held there. Therefore you need, as a minimum, the following installed:

• The AtomSpace
• The Storage component
• The CogServer
• Data in your AtomSpace. Up to you to generate this for yourself.

Status

Version 1.0.0 -- Performs basic visualization. Works. Nothing fancy.

Starting the CogServer

Start the CogServer using one of these methods:

Command Line:

/usr/local/bin/cogserver

From Guile Scheme:

(use-modules (opencog) (opencog cogserver))
(start-cogserver)

From Python:

import opencog, opencog.cogserver
opencog.cogserver.startCogserver()

Using the Visualizer

1. Open index.html in a web browser. Try it here.
2. Enter the WebSocket URL of your CogServer (default: ws://localhost:18080/)
3. Click "Connect" (the JSON endpoint will be automatically appended)
4. Once connected, the visualizer will automatically fetch and display AtomSpace statistics

Design

The visualizer was written entirely by Anthropic's Claude Code. Although attempts have been made to keep the code-base relatively clean and maintainable, the reality is that more or less everything here is going to be LLM slop. You should not try to hand-edit the code here; you should work with an LLM coding tool to make changes and updates here.

Troubleshooting

Connection Issues

• Verify the CogServer is running and accessible
• Check the WebSocket URL format (should be ws://host:port/)
• The visualizer will automatically append /json to connect to the JSON endpoint
• Ensure no firewall is blocking the WebSocket port
• Check browser console for detailed error messages
• Try the ../websockets/json-test.html page and check for errors.

No Data Displayed

• Confirm the CogServer has JSON endpoint enabled
• Use the debug console to test JSON commands
• Check that the AtomSpace contains atoms to display

Future Enhancements

Potential improvements for future versions:

• Graph visualization of atom relationships
• Real-time atom creation/deletion monitoring
• Atom type distribution charts
• Search and filter capabilities
• Export functionality for statistics
• Multi-server connection support

License

Part of the OpenCog project. See the main project license for details.