Create and Manage Desktop Projects

The Projects home page is where you:

  • Open and create projects.

  • Manage projects.

  • Review details of your Kineviz account, send feedback to Kineviz, and access user guides and communities.

Open a Project

Projects are displayed in either a tile or list view. Simply click a tile or list item to open the project.

20 02 01 KD OpenProjects

Projects are organized in sections:

  • Recent Projects, the projects you recently opened.

  • My Projects, projects you’ve created, and a Create tile or button.

  • Create From Sandbox, pre-configured projects you can review and copy. To introduce you to basic graph workflows, at least one Sandbox tutorial project is already included. These Kineviz tutorials use GraphXR’s Grove notebook extension.

Open a tutorial

Kineviz Sandbox tutorials guide you through basic workflows you are likely to encounter when exploring graph data.

  • Click to open the City Lifestyles Tutorial.

    You’ll learn to use GraphXR native tools and workflows to explore city livability data. You’ll import a CSV table, transform it to a labeled property graph, explore connections and patterns, and save graph views. You can also see how to use the Kineviz API within a Grove notebook to set up reproducible workflows for graph exploration.

    20 02 02 KD OpenSandbox

    Similar tutorials will demonstrate exploring the same data using AI Agent tools and workflows, and showcase more complex data and use cases as well.

The tutorials are in-app Grove notebooks. If you happen to close the tutorial panel, simply click the Grove_ icon on the left menu to re-open and resume.

Create and Open a New Project

To create a new project:

  1. In the Projects home page, click Create.

  2. In the Create New Project dialog:

    1. Enter a Project Name of your choice.

    2. Optionally, select the Database Type and enter the requested details for the specific database.

      KoreDB is the default, which automatically sets the specifications for the internal data store. Most other database options require a Hostname (or IP), BOLT port - a default is shown for most options, Username, Password, and Database Name. You may also need to verify that your external database is running before trying to connect to it.

  3. Click Confirm to create the project and open it.

    20 02 03 KD AddData

    A new project will not have any data in it yet. You can import data using any method, including:

    • Drag and drop (or navigate to and open) local data files.

    • Query the connected internal or external database, either using the no-code Query / Search bar, or through the full-featured Query panel.

    • Click the Chat icon to launch GraphXR Agent, a pre-configured AI Agent you can use to import, transform, and analyze data through no-code text chat. Using GraphXR Agent in Kineviz Desktop requires an Online connection to the managed Kineviz Cloud.

      When project already has saved data views, a list of recent views is displayed, and you can click to select a recent view to load.

Manage Projects

A tile or list item includes information and tools to review and edit a project:

  • Project name

  • Database badge showing the database type connected to the project (if any), e.g. NEO4J, SPAN (Spanner Graph), PUPPY (Puppygraph), KoreDB (for the internal project database), etc.

  • Sandbox badge on pre-configured sandbox projects.

  • Settings Menu to edit the project.

  • An optional brief description of the project.

  • The date the project was Created, and the date it was last Opened.

    20 02 04 KD HomeList

Search for a Project

To find a specific project, you can:

  • Use the Search bar at the top of the page to find one or more projects by name.

  • Use the dropdown menu in the My Projects section to sort projects by

    • Project name

    • Database type

    • Date created

    • Date last opened

Edit, Clone, or Delete a Project

In a project’s Settings menu select:

  • Edit project name, template, and/ or database type.

  • Clone to create a copy of the project.

  • Export Project to export the project to your local system as a .gxrproject file.

  • Protect from deletion / Allow deletion project options. When protected from deletion, a lock icon appears next to the project name.=.

  • Delete Project to delete the project, its saved views and internal graph database (but not data in an external connected graph database).

Export a Project

You can export an entire project from Kineviz Desktop (or GraphXR). All of its saved views and database connections are exported.

  • In an open project, click the export menu at the top right of the legend, and choose Export Project.

  • In the Projects home screen, click the Settings icon on a project tile or list item and choose Export Project.

    20 02 05 KD ExImProject

    An exported file includes the project name and a .gxrproject extension, for example: Tutorial.gxrproject. It can then be imported into any Desktop or GraphXR instance.

Import an Exported Project

You can import a project exported from either browser-based GraphXR or Kineviz Desktop.

To import an exported project:

  1. On the Projects screen, click Import Project.

  2. Navigate to a saved project, and click Open (or simply drag and drop the file on the dialog).

    The project is added to the Projects page, and you can click to open it.

Manage Your User Account

Go to the user menu at the top of the Projects page to edit your desktop account settings or log out:

  • Select Settings to review your Kineviz Desktop Configuration, Icon, and Cloud subscription. Under Cloud, you can click Manage account to update subscription, billing, and account details on the Kineviz Cloud website.

  • Select Logout to log out of Kineviz Desktop.

Select UI Language

Use the language selector at the top right of the Projects page to switch between default English, Chinese, or Spanish user interfaces.

20 02 06 KD LanguageMenu

Access Help and Community

Click links at the bottom of the Projects page:

  • Help opens user guides available on the Kineviz Help Center.

  • Feedback opens a form to submit questions or comments for Kineviz response.

  • Discord opens an invitation to join the Kineviz Discord community.