Metadata-Version: 2.1
Name: analyze-folder-for-llm
Version: 0.1.1
Summary: A tool for analyzing folder structures and content for use with large context on LLMs
Home-page: https://github.com/waveuphq/analyze-folder-for-llm
Author: jeblister
Author-email: jeblister@waveup.dev
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic <3.0.0,>=2.7.4
Requires-Dist: typer <0.13.0,>=0.12.3
Requires-Dist: rich <14.0.0,>=13.7.1
Requires-Dist: pyyaml <7.0.0,>=6.0.1
Provides-Extra: dev
Requires-Dist: pytest ; extra == 'dev'
Requires-Dist: black ; extra == 'dev'

# Analyze Folder for LLM

Analyze Folder for LLM is a Python library designed to collect text and code from a folder for use as context with large context Language Models (LLMs). This tool efficiently fetches README files, folder structures, and non-binary file contents, providing structured outputs complete with pre-formatted prompts to guide further analysis of the folder's content.

## Installation

You can install Analyze Folder for LLM using pip:

```bash
pip install analyze-folder-for-llm
```

## Usage

After installation, you can use the `folder_to_llm` command-line tool:

```bash
folder_to_llm --path "~/your_project_folder"
```

This will analyze the specified folder and generate output files in an `output` directory within the analyzed folder.

For more options:

```bash
folder_to_llm --help
```

You can also use it in your Python scripts:

```python
from analyze_folder_for_llm import folder_to_llm

result = folder_to_llm("~/your_project_folder")
print(result)
```

## Features

- Analyze folder structures
- Extract README contents
- Collect non-binary file contents
- Generate structured output for LLM consumption
- Customizable preset configurations
- Rich console output for easy readability

## Output

The tool generates two main output files in the `output` directory of the analyzed folder:

1. `folder_contents_for_llm.txt`: Contains the contents of all non-binary files in the analyzed folder.
2. `folder_analysis_for_llm.json`: Contains a structured analysis of the folder, including file structure, README summary, and analysis prompts.

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
