A comprehensive tool for analyzing codebases through file traversal, content summarization, and interactive querying.
- File Path Collection: Recursively traverse directories and collect file paths
- Content Summarization: Generate detailed summaries of code files using AI
- Interactive Query Interface: Query your codebase using natural language with voice support
- Clone the repository:
git clone <repository-url>
cd file_path_tool- Install dependencies:
pip install -r requirements.txt
cd rag_query_tool
pip install -r requirements.txt- Configure environment variables:
cp .env.example .env
# Edit .env with your API keys and preferences- Run the complete pipeline:
python MASTER.pyOr run individual components:
python main.py # File path collection
python summarize_files.py # Content summarization
python rag_query_tool/query_interface.py # Interactive querying- Traverses directories recursively
- Identifies empty folders
- Generates timestamped output files
- Processes files in batches or all at once
- Skips README files automatically
- Creates mirrored directory structure for summaries
- Supports multiple OpenAI models
- Natural language querying
- Voice input/output support
- Multiple TTS voices
- Response caching
- Offline fallback options
See .env.example for all available configuration options:
- OpenAI API settings
- ElevenLabs TTS configuration
- Speech recognition options
- Application preferences
- Python 3.8+
- OpenAI API key
- ElevenLabs API key (optional, for TTS)
- Google Cloud credentials (optional, for STT)
file_path_tool/
├── docs/ # Documentation
├── src/ # Core functionality
├── rag_query_tool/ # Query interface
├── summaries/ # Generated summaries
├── main.py # File traversal script
├── summarize_files.py # Summarization script
└── MASTER.py # Pipeline runner
- Fork the repository
- Create a feature branch
- Commit your changes
- Push to the branch
- Create a Pull Request
[Your chosen license]