---
id: tombi
version: "1.4.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# tombi — 🦅 TOML Toolkit 🦅

License: permissive · Maintenance: active · Downloads: 406.9K/mo

## What it is and what it does

Tombi is a TOML toolkit that bundles a formatter, linter, and language server into a single package. It's designed to help developers maintain consistent TOML file formatting and catch common issues in configuration files. The package is actively maintained, recently released, and has no external runtime dependencies, making it straightforward to install and use.

You can invoke Tombi from the command line to format or lint TOML files, or integrate it into your editor as a language server for real-time feedback. It supports modern Python versions (3.10 through 3.14) and is distributed as pre-built wheels across major platforms and architectures, so installation is typically fast and friction-free.

Use it for:

- Format TOML configuration files consistently across a project or team.
- Lint TOML files in a CI/CD pipeline to catch syntax errors and style issues before deployment.
- Integrate into an editor or IDE for real-time TOML validation and formatting suggestions.
- Standardize pyproject.toml, Cargo.toml, or other TOML-based config files in development workflows.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Tombi is a TOML formatter, linter, and language server that provides command-line tools and IDE integration for working with TOML files.

Yes. Tombi is actively maintained, has no external dependencies, carries a permissive MIT license, and offers a complete TOML toolkit (formatter, linter, language server) in one package. It's well-positioned in the ecosystem and has seen recent activity. Install it if you work regularly with TOML files and want a unified tool for formatting and validation.

## Install

pip install tombi
uv add tombi
poetry add tombi

## Installing tombi

Before you install: Active maintenance with a recent release (1 day old) and no runtime dependencies. Medium install friction due to platform-specific wheels, but pre-built binaries are available for macOS, Linux, Windows, and multiple architectures.

License in practice: Licensed under MIT (permissive), so you can use, modify, and distribute it freely with minimal restrictions.

Quickstart:

pip install tombi

# Format a TOML file
tombi format config.toml

# Or use as a language server in your editor

Requires Python 3.10 or later.

Verify before relying:

- Whether the language server integrates with specific editors (VS Code, Vim, etc.) and what setup is required.
- Performance characteristics on large TOML files or projects with many configuration files.
- Whether linting rules are configurable and what the default rule set covers.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 406.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

toml formatter, toml linter, toml language server, toml toolkit, toml code quality, toml editor support, toml validation, toml, formatter-linter, language-server

[View on SkillFed](https://skillfed.io/packages/tombi) · [View on PyPI](https://pypi.org/project/tombi/)