Spotrix

1.2.0 verified Sat May 09 auth: no python

Spotrix is a modern, enterprise-ready business intelligence web application that allows users to explore and visualize data using a no-code viz builder or a state-of-the-art SQL IDE. Version 1.2.0 is the latest stable release, with active development.

pip install spotrix

Common errors

error ImportError: cannot import name 'SpotrixApp' from 'spotrix' ↓

cause The main class was renamed in version 1.0.0-alpha from 'Spotrix' to 'SpotrixApp'.

fix

Use from spotrix import SpotrixApp instead of from spotrix import Spotrix. Also ensure you have installed version >=1.0.0.

error ModuleNotFoundError: No module named 'sqlalchemy' ↓

cause SQLAlchemy is a required dependency but not installed automatically in some packaging environments.

fix

Install SQLAlchemy: pip install sqlalchemy or use pip install spotrix[all].

error spotrix.exceptions.ConfigError: Missing required configuration 'SECRET_KEY' ↓

cause Spotrix requires a secret key for session management. Not set via environment or config file.

fix

Set the environment variable SPOTRIX_SECRET_KEY to a random string, or add SECRET_KEY: '<random>' to config.yaml.

Warnings

breaking In version 1.0.0-alpha, the configuration schema was reworked. Configs from older versions may not be compatible. ↓

fix Refer to the migration guide in the documentation to update your config.yaml.

deprecated The `spotrix.views` module is deprecated as of 1.2.0. Use `spotrix.routes` instead. ↓

fix Replace `from spotrix.views import ...` with `from spotrix.routes import ...`.

gotcha Spotrix requires a running database backend (e.g., PostgreSQL) for persistent storage. In-memory SQLite works for development but not for production. ↓

fix Set the `DATABASE_URL` environment variable to a proper database connection string.

Imports

SpotrixApp
```
from spotrix import SpotrixApp
```
Main application class. No known common mistake.
Config
wrong
```
from spotrix import Config
```
correct
```
from spotrix.config import Config
```
Config class is moved to a separate module in 1.1.0+.

Quickstart

Initialize and run Spotrix with default settings. For production, configure via environment variables or config file.

from spotrix import SpotrixApp
app = SpotrixApp()
app.run(host='0.0.0.0', port=8080)