# Basics

- [Before you begin](https://docs.degirum.com/axelera/basics/before-you-begin.md): Before exploring the guides and running examples, review this page to ensure you're set up for success. It covers how to install DeGirum's PySDK and DeGirum Tools with Axelera devices.
- [First inference](https://docs.degirum.com/axelera/basics/first-inference.md): Run your first inference using copy-paste-ready code.
- [Specifying a model](https://docs.degirum.com/axelera/basics/specifying-a-model.md): Before diving into code, read this page to understand how PySDK represents and handles models.
- [Discover Axelera models](https://docs.degirum.com/axelera/basics/specifying-a-model/discover-axelera-models.md): Start with precompiled Axelera models that run out of the box—learn how to pick the right variant for your device.
- [Inference setup](https://docs.degirum.com/axelera/basics/specifying-a-model/inference-setup.md): PySDK gives you flexibility in where models are stored and where inferences run. This page walks through common setups (cloud, local, and hybrid) so you can choose what fits your workflow.
- [Model properties](https://docs.degirum.com/axelera/basics/specifying-a-model/model-properties.md): See what you can tune on your model—and why it matters. This page introduces the model\_properties field and shows how to inspect, change, and group model settings by task.
- [Running inference](https://docs.degirum.com/axelera/basics/running-inference.md): Learn how to run inference with your model using simple, flexible methods—single images, video streams, or entire folders.
- [Images](https://docs.degirum.com/axelera/basics/running-inference/images.md): Run inference on a single image using a URL, file path, or NumPy array. This page shows how to use each input type with a loaded model.
- [Videos](https://docs.degirum.com/axelera/basics/running-inference/videos.md): Learn how to run real-time inference on video streams using predict\_stream. This page covers video files, webcams, and RTSP sources—all with minimal setup.
- [Folders](https://docs.degirum.com/axelera/basics/running-inference/folders.md): Run inference on entire image folders with predict\_dir, streaming results efficiently from flat or nested directories.
- [Inference results](https://docs.degirum.com/axelera/basics/inference-results.md): Understand the structure and purpose of the InferenceResults object returned by model inference. Learn how each field supports visualization, inspection, saving, or real-time streaming.
- [Inspecting results](https://docs.degirum.com/axelera/basics/inference-results/inspecting-results.md): Understand the structure of PySDK inference results so you can inspect labels, scores, and metadata before visualizing, saving, or streaming them.
- [Visualizing results](https://docs.degirum.com/axelera/basics/inference-results/visualizing-results.md): Learn how to view original frames, model-ready tensors, and overlay images returned in each inference result.
- [Saving results](https://docs.degirum.com/axelera/basics/inference-results/saving-results.md): Capture inference outputs as structured data or images so you can reuse them in downstream tools, dashboards, or datasets.
- [Streaming results](https://docs.degirum.com/axelera/basics/inference-results/streaming-results.md): Stream inference outputs in real time to displays, message buses, or remote services using PySDK result objects.
- [Measuring performance](https://docs.degirum.com/axelera/basics/measuring-performance.md): Measure latency and throughput for DeGirum models, capture per-stage timings, and apply repeatable test loops backed by consistent validation.


---

# 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/axelera/basics.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.
