Plug and play NebulaGraph with pip install.
Project description
NebulaGraph Lite
Try NebulaGraph with pip install, on Linux/ WSL2 or even Google Colab!
How to use
Install NebulaGraph Lite
pip3 install nebulagraph-lite
Start NebulaGraph Lite from Jupyter Notebook
from nebulagraph_lite import nebulagraph_let as ng_let
n = ng_let()
n.start()
Click to see how to start with Shell
Start NebulaGraph Lite from CLI:
nebulagraph start
Voilà! It'ts up and running already now!
What's next
Play with nebula3-python or ipython-ngql and walk through the Documentation!
pip3 install ipython-ngql
%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
- Binary Packages, if running on bare OS.
- K8s Operator, on K8s.
- NebulaGrpah Cloud, the managed NebulaGraph service.
Play and Dev
- Docker Compose, if you are comfortable 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
- udocker, https://github.com/indigo-dc/udocker
- docker-in-colab, https://github.com/drengskapur/docker-in-colab
- NebulaGraph Docker, https://github.com/vesoft-inc/nebula-docker-compose
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
- Step 4, kill the left processes, in case of any.
ss -plunt | grep "9559\|9669\|9779"
# if any, kill them with killall or other tools
killall -9 nebula-graphd
killall -9 nebula-storaged
killall -9 nebula-metad
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file nebulagraph_lite-0.0.9.tar.gz.
File metadata
- Download URL: nebulagraph_lite-0.0.9.tar.gz
- Upload date:
- Size: 13.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: pdm/2.11.2 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d4db9f802474bcdc964cd27a4d76ff57bbf4b5caf09de677c2852ce3c702636d |
|
| MD5 | 726a5534bd0f5fe34c0c3f0d7e86514a |
|
| BLAKE2b-256 | 3c98e37f6d14002c449c4d007044acb8b815ccd45bc3f6e65916bfe8ff9aeda5 |
File details
Details for the file nebulagraph_lite-0.0.9-py3-none-any.whl.
File metadata
- Download URL: nebulagraph_lite-0.0.9-py3-none-any.whl
- Upload date:
- Size: 13.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: pdm/2.11.2 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b542a0801f156141a3b65026696b34364ef89cf69b791f7205ac2acd81dc6e7e |
|
| MD5 | 71351d70c01a78b0d7ca2a74200612e8 |
|
| BLAKE2b-256 | f88193bbb0e109bf86f7bc960976944827e09430b71e2b36123b11aa16f279d8 |
