Skip to content

The minimal, ad-hoc way of plug and play NebulaGraph with pip install, even inside Colab Notebook!

License

Notifications You must be signed in to change notification settings

nebula-contrib/nebulagraph-lite

Repository files navigation

NebulaGraph-Lite-logo

NebulaGraph Lite

Try NebulaGraph with pip install, on Linux/ WSL2 or even Google Colab or ModelScope Notebook, in container, rootless.

Open in Colab ModelScope Jupyter for NebulaGraph pdm-managed

GitHub release (latest by date) pypi-version python-version

Build Checks

How to use

Install NebulaGraph Lite

pip3 install nebulagraph-lite

Start NebulaGraph Lite

From Jupyter Notebook: From CLI:
from nebulagraph_lite import nebulagraph_let as ng_let

n = ng_let()

n.start()
nebulagraph start  

Voilà! It'ts up and running already now!

Free NebulaGraph Playground in 5 minutes

Thanks to Google Colab and ModelScope Notebook, we could have a free NebulaGraph playground in 5 minutes.

Go with 👉 Open in Colab.

In China?

Go with 👉 Open in ModelScope

What's next

Play with nebula3-python or jupyter-nebulagraph and walk through the Documentation!

pip3 install jupyter-nebulagraph
%load_ext ngql

And we could access it like:

%ngql --address 127.0.0.1 --port 9669 --user root --password nebula

And query like:

%ngql SHOW HOSTS;

Other non-lite or less-lite options

Intrested in other play or production options?

Production

Play and Dev

  • Docker Compose, if you are comfortable to play with Docker on single server.
  • nebula-up, one-liner test env installer on single server, support studio, dashboard, nebulagraph algorithm, exchange etc, all-in-one.
  • Docker Extension, one-click on Docker Desktop(macOS, windows) on desktop machines, in GUI flavor.
  • Nebula-Operator-KinD, Nebula K8s Operator with K8s-in-Docker, one-liner test env with docker+k8s+nebulagrpah-operator, try NebulaGraph on K8s with ease on your single server.

Acknowledgements

Supported Platforms

Ubuntu ✔ Google Colab ✔ ModelScope Notebook ✔ RockyLinux ✔ NestedContainer ✔ WSL2 ✔

FAQ

Click to see FAQ

Why not docker?

With udocker, the opinionated subset docker running in user space, we could run docker images without root privilege, docker daemon.

Thus we support running inside docker container, WSL2, Google Colab.

Can NebulaGraph-Lite run inside a container?

Yes! Say we are in a container that runs Ubuntu, we could run:

docker run -it --rm ubuntu:latest bash
# inside the container
apt update && apt install python3-pip curl -y
pip3 install nebulagraph-lite
python3

In python3:

from nebulagraph_lite import nebulagraph_let as ng_let
n = ng_let(in_container=True)
n.start()

Or in shell:

nebulagraph --container start

Does it support Windows?

Yes, it supports Windows with WSL2 or other Linux VMs with a Hypervisor.

How to clean up?

  • Step 1, from nebulagraph-lite, remove the udocker container and clean up the base path.

Python:

n.stop()
n.clean_up()

Shell:

nebulagraph stop
nebulagraph cleanup
  • Step 2, pip uninstall nebulagraph-lite and dependencies.
pip3 uninstall nebulagraph-lite udocker
  • Step 3, remove the udocker files.
rm -rf ~/.udocker