What is a Senzing Project?

Installing the Senzing APIs creates a base install in /opt/senzing of the current Senzing version. 

To begin using Senzing, create a new Senzing project from the base install using the G2CreateProject.py script located in /opt/senzing/g2/python. G2CreateProject.py creates an independent and encapsulated instance of the base install in the path you specify. For example, the following command creates a new project in current users home directory and a new subdirectory called myNewProject:

• python3 /opt/senzing/g2/python/G2CreateProject.py ~/myNewProject

~/myNewProject now contains the required files to work with an instance of Senzing. The setup and configuration of this instance of Senzing is managed from within and with reference to the project path, not the base install. For example, if instructions call for modifying a file such as G2Module.ini it will be the ~/myNewProject/etc/G2Module.ini file.

You can create multiple projects. Advantages to creating projects include:

• A stable environment. When the base install is updated it does not interfere with previously created projects
• Update flexibility. When the base install is updated, choose a convenient time to update a project to the latest Senzing release.
• Security. Only the user who creates a project has permissions to it. 
• Testing flexibility. Test different database repositories, Senzing configurations, or other scenarios without the need to deploy a new server instance.

Tip

When you see <project_path> in the help articles, this is referencing a unique project such as ~/myNewProject created above.