Let's start with the installation of Sparksee graph database. Sparksee only needs to be downloaded and unpacked. Depending on which language you prefer, a few settings or considerations may need to be taken into account too.
By default Sparksee comes with a free personal evaluation license. Learn more about it in the last section of this chapter.
Sparksee is available for several programming languages, so the first thing you should do is download the right package for your development platform.
All the packages can be downloaded here.
Java developers can also get Sparksee through Apache Maven instead of manually downloading the packages. More information in Sparksee maven project.
Once you have downloaded Sparksee and unpacked it, the content should look like this:
According to the programming language particularities, some packages may include additional contents.
Unpack the downloaded Sparksee package and it's ready to be used. No further installation is required.
However, some additional steps can be taken to make Sparksee usage easier for your platform.
All the libraries required to develop a java application with Sparksee are contained in a jar file located at the
lib directory (
If you are not using Maven, you may want to add the path to this file into the
CLASSPATH environment variable. However, to avoid any misunderstandings, in this document we will explicitly use the file to compile the examples.
The .NET package contains two subdirectories in the
lib directory (
windows64) for 32 or 64 bit systems. In each one the main library included is
sparkseenet.dll. This is the library that you will need to include in your .NET projects.
All the other available libraries in the package are native dlls that
sparkseenet.dll must be able to find at run time. Although it is not required, you may want to copy all these libraries to your system folder.
lib folder contains native libraries for each available platform (Windows 32/64 bits, Linux 32/64 bits and MacOS 64 bits).
In Linux and MacOS, you may want to add the path to the correct subdirectory to your
LD_LIBRARY_PATH environment variable.
In Windows you can copy the libraries to the system folders or just be sure to always include them in your projects.
The rest of files included in this package, like the ones in the
includes directory, will be needed at compilation time. See Chapter 4.
lib contains the native libraries for each available platform (Windows 32/64 bits, Linux 32/64 bits and MacOS 64 bits) in addition to the Python module.
Make sure to include both the Python module (called sparksee.py) and the wrapper library named "_sparksee" in an accessible folder for Python, please refer to Python module search path for more information about the search path.
The other available library included in Sparksee's Python distribution is the dynamic native library. This must be located in a specific system directory defined by the following:
DYLD_LIBRARY_PATH for MacoOSX systems.
LD_LIBRARY_PATH for Linux systems.
PATH environment variable for Windows systems.
Every Sparksee download comes with a limited personal evaluation license included that does not require any further configuration. The personal evaluation license allows the construction of graphs with up to 1M objects, which is more than enough to construct the example explained in this guide.
If you have commercial interest or need to deal with larger databases, check Sparksee's website license section for licenses quotation on the latest release of Sparksee.
If you hold a license key, later in this document you will learn how to use your license for a project.