uv-rules

namingpaper is a specialized command-line interface (CLI) tool designed for researchers and academics to organize chaotic PDF file libraries. It eliminates manual renaming tasks by leveraging large language models to identify authors, publication years, journal titles, and paper names from raw document contents. The tool is built with a focus on reliability, utilizing dry-run modes by default to ensure file operations are safe and predictable.

• Automatically extracts metadata (authors, year, journal, title) from academic PDFs using AI.

• Supports multiple AI providers: Anthropic Claude, OpenAI, Google Gemini, and local Ollama models.

• Batch processing capability allows for renaming entire directory structures in one command.

• Customizable filename templates and support for common journal abbreviations like JFE, AER, and QJE.

• Collision handling strategies including skipping, incrementing, or overwriting files.

• Safe operation through dry-run mode, confirmation prompts, and output directory copying.

• Requires Python 3.11+ and is best installed via uv for dependency management.

• Use the rename command for individual files and batch for large collections.

• Configure API keys via environment variables (NAMINGPAPER_...) or a config.toml file in ~/.namingpaper/.

• Use --execute to apply changes after verifying the preview.

• The tool integrates with external providers; ensure local Ollama instances are running if using the default provider.

• Compatible with pipx for standard Python environment management.