SimpleDet Docs

SimpleDet static documentation

SimpleDet is a native object-detection toolkit for bbox training, inference, and evaluation. Define detectors with simpledet.suite, run them with the native runtime helpers, and keep experiments reproducible with one workdir per run.

Overview Quickstart Core Concepts API Reference

Start here if you want the shortest explanation of what the repo is for and how to navigate the rest of the docs.

Suite-first workflow

Build dense and ROI detectors with a small Python API instead of hand-editing low-level model wiring.

Open overview

Backbone auto-adaptation

Swap to any supported timm backbone and let SimpleDet patch necks, dense heads, and ROI extractors.

Open concepts

Reproducible experiments

Keep detector specs, dataset paths, checkpoints, logs, and evaluation outputs together in one pipeline workdir.

Open reproducibility

Notebook walkthroughs

Use the shipped notebooks for backbone discovery, dense and ROI detector assembly, training, inference, and evaluation.

Open notebook map

What problem this repo solves

Hand-editing low-level detection wiring is flexible, but it is also easy to make inconsistent experiments: backbone channels drift out of sync with the neck, class counts are duplicated in several places, and project runtime settings end up mixed into model definition. SimpleDet separates those concerns.

For researchers

Use the suite API to swap backbones and detector families quickly, then compare runs through one reproducible pipeline layout.

For engineers

Use the native runtime when you want stable artifacts, explicit dataset wiring, and a clear handoff from model definition to runtime execution.

For quick checks

Use the lightweight simpledet.detectors.* helpers only when you want a small smoke test without the full experiment stack.

Start here

Install the runtime in Installation.
Build and inspect your first detector in Quickstart.
Understand the runtime model in Core Concepts.
Choose a detector family from Examples.
Use Developer Guide when extending the suite.

Current public surface

simpledet --version and python -m simpledet --check-runtime for diagnostics.
simpledet.suite for DetectorSpec, builders, and native build plans.
simpledet.run_training, run_inference, and run_evaluation for native execution.
simpledet.ProjectConfig plus run_project for repeatable project-based runs.

If you are new to the repository, read these in order: Overview, Quickstart, Core Concepts, then Configuration Guide.