{"record":{"id":"fc43690215ff5e72","repo":"astral-sh/uv","slug":"pip-compile-s-config-is-unsupported-uv-does-n","errorCode":null,"errorMessage":"pip-compile's `--config` is unsupported (uv does not use a configuration file)","messagePattern":"pip-compile's `--config` is unsupported \\(uv does not use a configuration file\\)","errorType":"validation","errorClass":"anyhow::Error","httpStatus":null,"severity":"error","filePath":"crates/uv-cli/src/compat.rs","lineNumber":129,"sourceCode":"            return Err(anyhow!(\n                \"pip-compile's `--client-cert` is unsupported (uv doesn't support dedicated client certificates)\"\n            ));\n        }\n\n        if self.emit_trusted_host {\n            return Err(anyhow!(\n                \"pip-compile's `--emit-trusted-host` is unsupported\"\n            ));\n        }\n\n        if self.no_emit_trusted_host {\n            warn_user!(\n                \"pip-compile's `--no-emit-trusted-host` has no effect (uv never emits trusted hosts)\"\n            );\n        }\n\n        if self.config.is_some() {\n            return Err(anyhow!(\n                \"pip-compile's `--config` is unsupported (uv does not use a configuration file)\"\n            ));\n        }\n\n        if self.emit_options {\n            return Err(anyhow!(\n                \"pip-compile's `--emit-options` is unsupported (try `--emit-build-options` instead)\"\n            ));\n        }\n\n        if self.no_emit_options {\n            warn_user!(\"pip-compile's `--no-emit-options` has no effect (uv never emits options)\");\n        }\n\n        if self.pip_args.is_some() {\n            return Err(anyhow!(\n                \"pip-compile's `--pip-args` is unsupported (try passing arguments to uv directly)\"\n            ));","sourceCodeStart":111,"sourceCodeEnd":147,"githubUrl":"https://github.com/astral-sh/uv/blob/f1a42680ff5272232d65748acf338b19778dde24/crates/uv-cli/src/compat.rs#L111-L147","documentation":"pip-compile's `--config PATH` points at a pip.conf-style configuration file. uv's pip interface does not read pip configuration files at all — its settings come from CLI flags, environment variables, and `uv.toml`/`pyproject.toml` — so `PipCompileCompatArgs::validate()` rejects the flag rather than ignoring a file you expect to be honored. The pip-sync variant fails the same way (compat.rs:237).","triggerScenarios":"`uv pip compile --config pip.conf requirements.in` or `uv pip sync --config pip.conf requirements.txt` after migrating a pipeline that kept per-project pip configuration in a file.","commonSituations":"Monorepos with per-directory pip.conf; CI that parameterized pip-compile with a generated config file; teams assuming uv reads pip.conf because the subcommands are pip-compatible.","solutions":["Remove `--config` and move the settings into `uv.toml` (or `[tool.uv]`/`[tool.uv.pip]` in pyproject.toml) next to the requirements file.","Translate remaining options to CLI flags or `UV_*` environment variables in the script.","Use `--isolated`-style explicitness: keep all uv pip settings in version control so no ambient config is needed."],"exampleFix":"# before\nuv pip compile --config pip-tools.conf requirements.in\n\n# after (uv.toml)\n# [[pip.index]]\n# url = \"https://pypi.internal/simple\"\nuv pip compile requirements.in","handlingStrategy":"validation","validationCode":"def assert_no_pip_config(argv: list[str]) -> None:\n    if any(a == \"--config\" or a.startswith(\"--config=\") for a in argv):\n        raise ValueError(\"uv does not read pip config files; move settings to uv.toml or flags\")","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Translate pip.conf/pip-tools.conf entries into uv.toml once, in the same change that migrates the command.","Store per-project uv settings in version control next to requirements files.","Document which env vars (UV_*) replace each old pip.conf entry."],"tags":["cli","pip-tools","compatibility","configuration","compile"],"backgroundTag":null,"analyzedSha":"f1a42680ff5272232d65748acf338b19778dde24","analyzedAt":"2026-08-16T04:51:47.599Z","schemaVersion":2},"datasetVersion":"2026-08-16T08:17:34.114Z"}