Grok with tavily

.env.example

@@ -0,0 +1,23 @@
+# GrokSearch 环境变量配置
+# 复制此文件为 .env 并填入实际值
+
+# === 必填 ===
+GROK_API_KEY=your-grok-api-key
+GROK_API_URL=https://api.x.ai/v1
+GROK_MODEL=grok-4.1-fast
+
+# === Tavily（可选，增强搜索来源） ===
+TAVILY_API_KEY=your-tavily-api-key
+TAVILY_API_URL=https://api.tavily.com
+
+# === Firecrawl（可选） ===
+# FIRECRAWL_API_KEY=your-firecrawl-api-key
+# FIRECRAWL_API_URL=https://api.firecrawl.dev/v2
+
+# === 会话配置（可选，有默认值） ===
+# GROK_SESSION_TIMEOUT=600      # 会话超时（秒），默认10分钟
+# GROK_MAX_SESSIONS=20          # 最大并发会话数
+# GROK_MAX_SEARCHES=50          # 单会话最大搜索次数
+
+# === 调试 ===
+# GROK_DEBUG=true

.github/workflows/release.yml

@@ -0,0 +1,33 @@
+name: Build & Release
+
+on:
+  push:
+    tags:
+      - "v*"          # 推送 v0.1.0、v1.2.3 等 tag 时触发
+
+permissions:
+  contents: write      # 允许创建 Release 和上传 asset
+
+jobs:
+  build-and-release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build wheel & sdist
+        run: python -m build
+
+      - name: Create GitHub Release & upload assets
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          generate_release_notes: true

.gitignore

@@ -0,0 +1,41 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+*.egg
+
+# Environment
+.env
+.env.local
+
+# Logs
+logs/
+*.log
+
+# Local runtime/config artifacts
+.config/
+.pytest_cache/
+tool_test_report_*.md
+output.txt
+schema_out*.json
+
+# Test outputs
+test_output.*
+test_cqnu*
+test_cqnu.py
+test_followup.py
+test_new_tools_output.json
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+.ace-tool/