Deep dives#

Detailed explorations of particularly complex subsystems in conda. These guides go beyond the high-level architecture and explain the internal mechanics of specific components.

conda install #: A thorough walkthrough of what happens when you run conda install: from parsing the command line through repodata fetching, the solver, transaction planning, and finally linking packages into the environment.
conda init and conda activate #: How conda manages shell integration, virtual environment activation and deactivation scripts, and the conda init bootstrap process.
conda config and context #: The central Context object: how settings are loaded from defaults, .condarc files, environment variables, and command-line flags, and how they are merged with the correct precedence.
Programmatic .condarc API #: How to programmatically read and write conda configuration files using the internal .condarc file API.
Solvers #: Inside the solver black box: how conda constructs the MatchSpec inputs, drives the SAT solver, and handles conflicts and retries.
Solver state #: A technical reference for how the list of MatchSpec objects passed to the SAT solver is constructed from prefix state, history, pins, and other inputs.
Logging #: The loggers and handlers used throughout conda, how they are configured, and how to work with them during development and debugging.
Sharded repodata #: How conda implements CEP-16 sharded repodata: the fetch loop, threading model, SQLite shard cache, and the deliberate decision not to validate shard contents against their content-addressable SHA-256 filename hash.