feat: Establish initial project structure for TreeRAG, including MCTS engine, PDF processing, LLM integration, and core application components.

Author: CyberGhost007

.env.example

@@ -0,0 +1,27 @@
+# Required
+OPENAI_API_KEY=sk-your-api-key-here
+
+# Models
+INDEXING_MODEL=gpt-4o
+SEARCH_MODEL=gpt-4o-mini
+ANSWER_MODEL=gpt-4o
+
+# MCTS — Phase 2 (per-document)
+MCTS_ITERATIONS=25
+UCB_EXPLORATION_CONSTANT=1.414
+CONFIDENCE_THRESHOLD=0.7
+
+# MCTS — Phase 1 (document selection)
+MCTS_META_ITERATIONS=15
+TOP_K_DOCUMENTS=3
+
+# Parallel
+PARALLEL_PHASE2=true
+
+# Indexing
+BATCH_SIZE=15
+MAX_PAGES=5000
+
+# Storage
+TREERAG_DATA_DIR=.treerag_data
+AUTO_REINDEX=true

.github/workflows/test.yml

@@ -0,0 +1,31 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install pytest pytest-cov
+
+      - name: Run tests
+        run: pytest --cov=treerag --cov-report=term-missing -v

.gitignore

@@ -0,0 +1,43 @@
+# Environment
+.env
+.env.local
+
+# Data
+.treerag_data/
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.pytest_cache/
+.coverage
+htmlcov/
+venv/
+.venv/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Claude Code
+.claude/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+
+# Firebase
+firebase-debug.log
+.firebase/

CODE_OF_CONDUCT.md

@@ -0,0 +1,40 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior:
+
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by opening an issue or contacting the project maintainer. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org),
+version 2.0.

CONTRIBUTING.md

@@ -0,0 +1,52 @@
+# Contributing to AlphaSearch
+
+Thanks for your interest in contributing! Here's how to get started.
+
+## Development Setup
+
+```bash
+git clone https://github.com/CyberGhost007/alphasearch.git
+cd alphasearch
+python -m venv venv
+source venv/bin/activate  # Windows: venv\Scripts\activate
+pip install -r requirements.txt
+cp .env.example .env
+# Edit .env with your OpenAI API key
+```
+
+## Making Changes
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/your-feature`
+3. Make your changes
+4. Test your changes locally with `python server.py`
+5. Commit with a clear message: `git commit -m "feat: add your feature"`
+6. Push to your fork: `git push origin feature/your-feature`
+7. Open a Pull Request
+
+## Commit Messages
+
+Use conventional commits:
+- `feat:` new feature
+- `fix:` bug fix
+- `docs:` documentation only
+- `refactor:` code change that neither fixes a bug nor adds a feature
+- `test:` adding or updating tests
+
+## Code Style
+
+- Follow existing patterns in the codebase
+- Use type hints for function signatures
+- Add docstrings to public functions and classes
+- Keep functions focused and small
+
+## Reporting Issues
+
+- Use GitHub Issues
+- Include steps to reproduce
+- Include Python version and OS
+- Include relevant error messages/logs (redact any API keys)
+
+## Questions?
+
+Open a Discussion or Issue on GitHub.