Flamehaven-Filesearch AI技能包

+ Image OCR (Pillow + pytesseract; requires Tesseract system binary)

pip install flamehaven-filesearch[vision]

Required Environment Variables

```bash export FLAMEHAVEN_ADMIN_KEY="your_secure_admin_password"

Option 1: Docker (Recommended)

The fastest path to production:

docker run -d \
  -p 8000:8000 \
  -e GEMINI_API_KEY="your_gemini_api_key" \
  -e FLAMEHAVEN_ADMIN_KEY="secure_admin_password" \
  -v $(pwd)/data:/app/data \
  flamehaven-filesearch:1.6.4

✅ Server running at http://localhost:8000

📦 Installation

```bash

Build from source

git clone https://github.com/flamehaven01/Flamehaven-Filesearch.git cd Flamehaven-Filesearch docker build -t flamehaven-filesearch:1.6.4 . ```

LangChain (pip install langchain-core)

from flamehaven_filesearch.integrations import FlamehavenLangChainLoader docs = FlamehavenLangChainLoader("report.pdf", chunk=True).load()

LlamaIndex (pip install llama-index-core)

from flamehaven_filesearch.integrations import FlamehavenLlamaIndexReader nodes = FlamehavenLlamaIndexReader(chunk=True).load_data(["report.pdf", "slides.pptx"])

Haystack (pip install haystack-ai)

from flamehaven_filesearch.integrations import FlamehavenHaystackConverter result = FlamehavenHaystackConverter().run(sources=["report.pdf"])

CrewAI (pip install crewai)

from flamehaven_filesearch.integrations import FlamehavenCrewAITool tool = FlamehavenCrewAITool() # pass to your agent's tools list ```

---

Quick Start 🚀

Option 2: Python SDK

Perfect for integrating into existing applications:

```python from flamehaven_filesearch import FlamehavenFileSearch, FileSearchConfig

Option 3: REST API

For language-agnostic integration:

```bash

Configuration ⚙️

Optional Configuration

export HOST="0.0.0.0"              # Bind address
export PORT="8000"                  # Server port
export REDIS_HOST="localhost"       # Distributed caching
export REDIS_PORT="6379"            # Redis port
export MAX_OUTPUT_TOKENS="1024"     # Max answer tokens
export TEMPERATURE="0.5"            # Model temperature (0.0–1.0)
export MAX_SOURCES="5"              # Max source documents per answer

Obsidian / Local Vault Configuration

For Markdown-heavy vaults, enable Obsidian light mode:

export OBSIDIAN_LIGHT_MODE=true
export OBSIDIAN_CHUNK_MAX_TOKENS=256
export OBSIDIAN_CHUNK_MIN_TOKENS=32
export OBSIDIAN_CONTEXT_WINDOW=1
export OBSIDIAN_RESPLIT_CHUNK_CHARS=1200
export OBSIDIAN_RESPLIT_OVERLAP_CHARS=160

This path preserves note structure and improves retrieval on dense vaults with many related notes. Operational details: Obsidian Light Mode

Advanced Configuration

Create a config.yaml for fine-tuned control:

vector_store:
  quantization: int8
  compression: gravitas_pack
  
search:
  default_mode: hybrid
  typo_correction: true
  max_results: 10
  
security:
  rate_limit: 100  # requests per minute
  max_file_size: 52428800  # 50MB

---

Configure Redis memory limit

docker run -d \ -p 6379:6379 \ redis:7-alpine \ --maxmemory 512mb \ --maxmemory-policy allkeys-lru ``` </details>

More solutions in our Wiki Troubleshooting Guide.

---

Ollama — fully local, zero API cost (Gemma, Llama, Mistral, Qwen, Phi …)

1. Generate API key

curl -X POST http://localhost:8000/api/admin/keys \ -H "X-Admin-Key: your_admin_key" \ -d '{"name":"production","permissions":["upload","search"]}'

+ Google Gemini API

pip install flamehaven-filesearch[google]

+ REST API server (FastAPI + uvicorn)

pip install flamehaven-filesearch[api]

Rotate API keys regularly

curl -X DELETE http://localhost:8000/api/admin/keys/old_key_id \ -H "X-Admin-Key: $FLAMEHAVEN_ADMIN_KEY" ```

---

Regenerate API key

curl -X POST http://localhost:8000/api/admin/keys \ -H "X-Admin-Key: $FLAMEHAVEN_ADMIN_KEY" \ -d '{"name":"debug","permissions":["search"]}'

</details>

<details>
<summary><b>🐌 Slow Search Performance</b></summary>

**Problem:** Searches taking >5 seconds.

**Solutions:**
1. Check cache hit rate: `FLAMEHAVEN_METRICS_ENABLED=1 curl http://localhost:8000/metrics`
2. Enable Redis for distributed caching
3. Verify Gemini API latency (should be <1.5s)

Core package (HTML, CSV, LaTeX, WebVTT, plain-text parsing included — zero extra deps)

pip install flamehaven-filesearch

Framework Integrations

Framework SDKs (LangChain, LlamaIndex, etc.) are imported lazily — install only what you need:

```python

Troubleshooting 🐛

<details> <summary><b>❌ 401 Unauthorized Error</b></summary>

Problem: API returns 401 when making requests.

Solutions: 1. Verify FLAMEHAVEN_ADMIN_KEY environment variable is set 2. Check Authorization: Bearer sk_live_... header format 3. Ensure API key hasn't expired (check admin dashboard)

```bash