OpenVIDA

OpenVIDA is an open-source, web-based parts catalogue and document repository for the maintenance and repair of Volvo vehicles up to model year 2016.

Table of Contents

• OpenVIDA
  • Table of Contents
  • Features
  • Getting Started
    • Prerequisites
    • Running Locally
    • Local Python Workflow (Without Docker)
  • Configuration
  • Development
  • Contributing
  • License

Features

• Browse OEM parts catalogues for Volvo vehicles (up to MY2016)
• Access maintenance and repair documentation
• Lightweight Flask-based web application
• Docker support for easy local development and deployment

Getting Started

Prerequisites

• Docker and Docker Compose

Running Locally

1. Clone the repository:

   git clone https://github.com/kForth/OpenVIDA.git
   cd OpenVIDA

2. Create a local environment file:

   cp .env.example .env

   Set VIDA_XSL_HOST_PATH and VIDA_DB_HOST_PATH in .env to absolute host paths before starting Docker.

3. Start the development server:

   docker-compose up -d flask-dev

4. Open your browser and navigate to http://localhost:5000.

Local Python Workflow (Without Docker)

1. Create and activate a virtual environment.
2. Install development dependencies:

   pip install -r requirements/dev.txt

3. Configure .env from .env.example.
4. Run the app:

   flask --app autoapp.py run

Configuration

The project reads settings from environment variables. Start from .env.example and set at minimum:

• DATABASE_URL
• SECRET_KEY
• VIDA_XSL_PATH

See .env.example for additional supported variables.

Development

Recommended checks before opening a PR:

ruff check openvida
mypy openvida
pytest

Contributing

Contributions are welcome. See CONTRIBUTING.md for workflow and standards.

License

OpenVIDA © 2026 Kestin Goforth

This project is licensed under the MIT License. See the LICENSE file for details.