NetMotif

Local Development Setup

Note: This application is currently supported only on Linux systems. Please ensure you are using a Linux environment to run the app.

Follow the steps below to set up the project for local development using uv:

1. Clone the Repository

Start by cloning this repository to your local machine:

git clone https://github.com/your-username/your-repo.git
cd your-repo

2. Install uv if you don't have it

If you don't have uv installed, use one of the commands below, or refer here:

# On macOS and Linux.
$ curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows.
$ powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# With pip.
$ pip install uv

3. Activate the Virtual Environment

# Set up .venv if haven't yet
$ uv venv

# On MacOS and Linux.
$ source .venv/bin/activate

# On Windows.
$ .venv\Scripts\activate

4. Install Project Dependencies

uv sync

5. Run the Streamlit App

streamlit run app.py

This will launch the app, and you can access it by navigating to http://localhost:8501 in your browser.

Project Directory

├── app.py    # main entry used by streamlit to activate app
├── data/     # contains graph input examples
├── drawings/ # contains generated graphs, no need to be touched
├── labelg    # labelg C program
├── lib/      # contains code auto generated by pyvis, no need to be touched
├── out/      # contains canonical output
├── src/      # contains scripts for the program

References

Graph6 and Digraph6 format: https://users.cecs.anu.edu.au/~bdm/data/formats.txt