FineCode gives you one workflow for code quality and developer tooling across CLI, IDE, CI, and AI assistants.
- Unifies tool execution across local CLI, IDE, CI and AI
- Keeps tooling config reusable via presets
- Supports multi-project workspaces
- Isolates tooling dependencies in dedicated virtual environments
- Python 3.11-3.14
- pip 25.1+ (for
--groupsupport)
- Add dependencies and FineCode config to
pyproject.toml:
[dependency-groups]
dev_workspace = ["finecode==0.3.*", "fine_python_recommended==0.3.*"]
[tool.finecode]
presets = [{ source = "fine_python_recommended" }]- Create and activate environment:
python -m venv .venvs/dev_workspace
# macOS/Linux
source .venvs/dev_workspace/bin/activate
# Windows (PowerShell)
.venvs\dev_workspace\Scripts\Activate.ps1
# Windows (cmd.exe)
.venvs\dev_workspace\Scripts\activate.bat- Install dependencies and run FineCode:
python -m pip install --upgrade pip
python -m pip install --group="dev_workspace"
python -m finecode prepare-envs
python -m finecode run lint- (Optional, but recommended) Enable FineCode in development environments you use:
- IDE (VSCode): IDE Integration docs and FineCode VSCode extension
- AI assistants (MCP): MCP setup
- Git hooks: Use the same actions in local/CI/hooks workflows
For full setup and recommended presets, see: Getting Started
- Start here
- Concepts
- CLI
- Configuration
- IDE Integration (LSP, VSCode, MCP)
- Guide: Creating an Extension
- Guide: Creating a Preset
- Guide: Multi-Project Workspace
- Reference: Built-in Actions
- Reference: Extensions
See Development for local development workflow.