Introduction

Visivo is an open-source, fully code-based, data-visualization tool that enables users to create interactive and customizable dashboards for their data.

It provides a simple and intuitive way to connect to various data sources, reuse queries and charts, and share insights with others.

Here are some examples

Usage

Please refer to https://docs.visivo.io for detailed instructions on how to use this package.

Install

We have an install script for a self contained binary.

Install Latest Version

curl -fsSL https://visivo.sh | bash

Install Specific Version

To install a specific version, you can pass the version as a parameter:

# Install version 1.0.64
curl -fsSL https://visivo.sh | bash -s -- --version 1.0.64

# Or with the 'v' prefix
curl -fsSL https://visivo.sh | bash -s -- --version v1.0.64

# Short form
curl -fsSL https://visivo.sh | bash -s -- -v 1.0.64

Installation Help

To see all available installation options:

curl -fsSL https://visivo.sh | bash -s -- --help

Note: To find available versions, check the releases page or the tags on this repository.

Python Installation

If you have Python setup and want to use it through pip install:

pip install visivo

If you want to install a preview version you can install from a beta tag:

python -m pip install git+https://github.com/visivo-io/visivo.git@v1.1.0-beta-1 --force-reinstall

Quickstart

To get started with Visivo, follow these steps:

Option 1: CLI-Guided Setup with init

This approach is ideal if you prefer setting things up through the command line with control over source selection.

1. Install Visivo

   curl -fsSL https://visivo.sh | bash

2. Initialize a new project

   visivo init --project-dir quick_start

3. Choose a data source Select sqlite for the fastest setup during initialization.

4. Navigate to your project directory

   cd quick_start

5. Start the development server

   visivo serve

6. Open your browser Go to http://localhost:8000 to start building charts.

---

Option 2: UI-Guided Setup with serve

If you prefer a more visual and guided setup without manually initializing the project, you can start directly:

1. Install Visivo

   curl -fsSL https://visivo.sh | bash

2. Start the server in any empty directory

      visivo serve --project-dir quick_start

3. Configure everything through the UI Once running, Visivo will walk you through data source selection and setup via your browser.

Telemetry

Visivo collects anonymous usage telemetry to help improve the tool. This data helps us understand which features are used most and identify areas for improvement.

Privacy First: We do not collect any personal information, file contents, queries, or sensitive data.

To opt out of telemetry, you can:

• Set the environment variable: export VISIVO_TELEMETRY_DISABLED=true
• Or add to your project configuration: telemetry_enabled: false

For more details, see TELEMETRY.md.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Contributing

There are two pieces to the local Visivo deployment, the python CLI and the javascript viewer. When packaged, the viewer is contained in the CLI, but it is needed to be able to develop them separately locally.

CLI

The development of the python CLI is straight forward. The code is contained within the visivo folder in this repo, and we use poetry as its package manager.

Prerequisites

1. Python 3.10+
2. Poetry: pip install poetry
3. Dependencies: poetry install

After this, you can install the visivo package from the files in the repo. This keeps the visivo ... commands in sync with your github repo because it reads those commands from the files on your computer.

pip install -e .

Commands

• Test: poetry run pytest
• Server: visivo serve

Viewer

The local development environment is a basic vite app. It uses yarn as its package manager and commands can be found in the package.json.

Prerequisites

1. Node 20+
2. Yarn: npm install -g yarn
3. Dependencies: yarn install

Commands

• Test: yarn test
• Start: yarn start

If you need to run it locally as an app, you need a API for it to proxy to. You can do this be running visivo on a local project by:

1. Install Visivo from above. Either the development or pip install.
2. Start visivo serve on a project. You can do this in on test-projects in this repo. This acts as the server for your changes.
3. In another terminal start the react app. a. cd viewer b. yarn start c. Navigate to localhost:3000 this will proxy any data requests to the running visivo serve command

Generating a Release

A release is created by running the action Create Release. This will create a tag and trigger the deployment of the viewer. The input is without the v prefix. Example: 1.3.4.

Authors

• Visivo LLC - visivo.io

Our team has experienced building analytics at fast growing companies and scaling systems at household names like Intuit, Boeing and Root Insurance.

See also the list of contributors who participated in this project.

Join Our Community

• File a GitHub issue.
• Send us an email info@visivo.io.
• Read our blog.