---
id: types-appdirs
version: "1.4.3.5"
license: Apache-2.0 license
license_treatment: permissive
maintenance: active
---

# types-appdirs — Typing stubs for appdirs

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

## What it is and what it does

types-appdirs is a PEP 561 type stub package that adds static type information to the appdirs library. It allows type checkers like mypy, pyright, and pytype to understand and validate code that uses appdirs, catching type errors at development time rather than runtime.

The package is generated from typeshed and serves as a bridge for projects still using appdirs. However, the description explicitly states the package is unmaintained and won't be updated. The appdirs library itself has been deprecated in favor of platformdirs, which includes native type support via a py.typed file, making this stub package unnecessary for new projects.

Use it for:

- Enable type checking in legacy codebases that still depend on appdirs without migrating to platformdirs.
- Satisfy type checker requirements in projects using appdirs while maintaining compatibility with existing code.
- Provide IDE autocomplete and type hints for appdirs calls in editors like PyCharm and VS Code.

## Worth the install?

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

Provides type stubs for the appdirs package to enable static type checking with mypy, pyright, pytype, and similar tools.

No, unless you are maintaining legacy code that uses appdirs and cannot migrate to platformdirs. The package is unmaintained and will not receive updates. New projects should use platformdirs directly, which provides native type support without requiring a separate stub package.

## Install

pip install types-appdirs
uv add types-appdirs
poetry add types-appdirs

## Installing types-appdirs

Before you install: Low install friction with no runtime dependencies. However, the package is unmaintained and won't be updated; the description explicitly recommends migrating to platformdirs instead, which ships with native type support.

License in practice: Apache-2.0 license is permissive and poses no restrictions on use, modification, or distribution in most contexts.

Quickstart:

pip install types-appdirs

# Then use appdirs in your code; type checkers will now understand its types
import appdirs
config_dir = appdirs.user_config_dir('myapp')

Requires appdirs to be installed separately; this package only provides type information for it.

Verify before relying:

- Whether type coverage is complete for all appdirs APIs or if gaps remain.
- Compatibility with the latest versions of mypy, pyright, and other type checkers.

## Package facts

- License: Apache-2.0 license (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 228.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

type stubs appdirs, mypy stubs for appdirs, static type checking appdirs, PEP 561 type stubs, appdirs type hints, pyright type stubs, typing stubs appdirs, type-stubs, deprecated, legacy-support

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