# Installation & Setup

## Prerequisites

* **Python & OS Requirements:** See [DeGirum PySDK Documentation](https://docs.degirum.com/pysdk/installation)
* **DeGirum AI Hub Account:** Create an account at [AI Hub](https://hub.degirum.com/) and set up a workspace with the appropriate permissions to generate licenses for `degirum-vehicle`. See [Workspace Plans](https://docs.degirum.com/ai-hub/workspace-plans) for plan details and [Manage AI Hub Tokens](https://docs.degirum.com/pysdk/user-guide-pysdk/command-line-interface#manage-ai-hub-tokens) for setting up your authentication token
* **Hardware Acceleration (optional):** See [Runtimes & Drivers](https://docs.degirum.com/pysdk/runtimes-and-drivers) for hardware-specific runtime setup

***

## Setup Workflow

Follow these steps to get started with `degirum-vehicle`:

1. **Create AI Hub Account:** Sign up at [AI Hub](https://hub.degirum.com/) if you don't have an account
2. **Set up Workspace:** Create or join a workspace with the appropriate plan (see [Workspace Plans](https://docs.degirum.com/ai-hub/workspace-plans))
3. **Generate Token:** Follow the [token management guide](https://docs.degirum.com/pysdk/user-guide-pysdk/command-line-interface#manage-ai-hub-tokens) to set up authentication
4. **Install Package:** Run `pip install -i https://pkg.degirum.com degirum-vehicle`
5. **(Optional) Install Hardware Drivers:** If using hardware acceleration, set up the required drivers

***

## Installation

DeGirum hosts its own PyPI server for DeGirum packages.

```bash
pip install -i https://pkg.degirum.com degirum-vehicle
```

***

## Verify Installation

Quick test to verify the package is installed correctly:

```python
import degirum_vehicle
from degirum_tools import remote_assets

# Create LP recognizer with default configuration
lpr = degirum_vehicle.LicensePlateRecognizer(
    degirum_vehicle.LicensePlateRecognizerConfig()
)

# Process a demo image
result = lpr.predict(remote_assets.car)

# Display results
for plate in result.license_plates:
    print(f"Plate: {plate.plate_number}, OCR Score: {plate.ocr_score:.2f}")
```

If this runs without errors, the package is installed correctly!

## Next Steps

Continue to [Basic Concepts](/vehicle-analytics/getting-started/basic-concepts.md) to learn about the core components of degirum-vehicle.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.degirum.com/vehicle-analytics/getting-started/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.