tunacode-cli 0.0.73__tar.gz → 0.0.75__tar.gz

tunacode_cli-0.0.75/.github/workflows/publish.yml

@@ -0,0 +1,80 @@
+name: Publish to PyPI
+
+"on":
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Install build tooling
+        run: |
+          python -m pip install --upgrade pip
+          pip install hatch twine uv
+
+      - name: Determine version from tag
+        id: ver
+        shell: bash
+        run: |
+          # Prefer release tag when present; fall back to ref name
+          if [ "${{ github.event_name }}" = "release" ]; then
+            TAG="${{ github.event.release.tag_name }}"
+          else
+            TAG="${{ github.ref_name }}"
+          fi
+          TAG="${TAG#v}"
+          echo "tag=$TAG" >> "$GITHUB_OUTPUT"
+
+      - name: Check version consistency
+        shell: bash
+        run: |
+          TAG="${{ steps.ver.outputs.tag }}"
+          # Extract only the [project] version from pyproject.toml
+          PYPROJ=$(awk '
+            /^\[project\]/ { in_proj=1; next }
+            /^\[/ { if (in_proj) exit }
+            in_proj && /^version =/ { match($0, /"([^"]+)"/, m); print m[1]; exit }
+          ' pyproject.toml)
+          # Extract APP_VERSION from constants
+          CONST=$(awk -F '"' '/^APP_VERSION =/ { print $2; exit }' src/tunacode/constants.py)
+          echo "Tag: $TAG"
+          echo "pyproject.toml: $PYPROJ"
+          echo "constants.APP_VERSION: $CONST"
+          if [[ "$TAG" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            [[ "$TAG" == "$PYPROJ" ]] || { echo 'pyproject.toml version mismatch'; exit 1; }
+            [[ "$TAG" == "$CONST" ]] || { echo 'constants.py APP_VERSION mismatch'; exit 1; }
+          else
+            echo "No semver tag detected; skipping tag consistency check."
+          fi
+
+      - name: Lint
+        run: hatch run lint-check
+
+      - name: Test
+        run: hatch run test
+
+      - name: Build
+        run: hatch build
+
+      # Preferred: API token secret
+      - name: Publish to PyPI (API token)
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: python -m twine upload dist/*
+
+      # Fallback: username/password secrets
+      - name: Publish to PyPI (user/pass)
+        env:
+          TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}
+          TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
+        run: python -m twine upload dist/*

{tunacode_cli-0.0.73 → tunacode_cli-0.0.75}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tunacode-cli
-Version: 0.0.73
+Version: 0.0.75
 Summary: Your agentic CLI developer.
 Project-URL: Homepage, https://tunacode.xyz/
 Project-URL: Repository, https://github.com/alchemiststudiosDOTai/tunacode

tunacode_cli-0.0.75/documentation/configuration/environment-variables.md

@@ -0,0 +1,195 @@
+# Environment Variables Configuration
+
+The `.env.example` file demonstrates all environment variables that can be used to configure TunaCode. These variables provide an alternative method for setting API keys and configuration options.
+
+## File Usage
+
+1. **Copy the example file**:
+   ```bash
+   cp documentation/configuration/.env.example .env
+   ```
+
+2. **Edit with your values**:
+   ```bash
+   # Set your actual API keys
+   ANTHROPIC_API_KEY="sk-ant-api03-your-key-here"
+   OPENAI_API_KEY="sk-proj-your-key-here"
+   ```
+
+3. **Load the environment**:
+   ```bash
+   # Load variables in your shell
+   source .env
+
+   # Or use with direnv (auto-loading)
+   echo "dotenv" > .envrc
+   ```
+
+## Environment Variables
+
+### Required API Keys
+
+**Anthropic Claude**
+- `ANTHROPIC_API_KEY`: Required for Claude models
+- Format: `sk-ant-api03-...`
+- Get from: https://console.anthropic.com
+
+**OpenAI**
+- `OPENAI_API_KEY`: Required for OpenAI models (GPT-3.5, GPT-4, etc.)
+- Format: `sk-proj-...`
+- Get from: https://platform.openai.com/api-keys
+
+### Optional API Keys
+
+**Google Gemini**
+- `GOOGLE_API_KEY`: For Google Gemini models
+- Get from: https://makersuite.google.com/app/apikey
+
+**Perplexity**
+- `PERPLEXITY_API_KEY`: For Perplexity AI models
+- Format: `pplx-...`
+- Get from: https://www.perplexity.ai/settings/api
+
+**Mistral AI**
+- `MISTRAL_API_KEY`: For Mistral models
+- Get from: https://console.mistral.ai/api-keys
+
+**xAI**
+- `XAI_API_KEY`: For xAI models (Grok)
+- Get from: https://console.x.ai
+
+**Groq**
+- `GROQ_API_KEY`: For Groq's fast inference
+- Get from: https://console.groq.com
+
+**OpenRouter**
+- `OPENROUTER_API_KEY`: For OpenRouter models
+- Get from: https://openrouter.ai/keys
+
+**Azure OpenAI**
+- `AZURE_OPENAI_API_KEY`: For Azure OpenAI services
+- Requires additional configuration in `tunacode.json` for endpoint
+
+**Ollama**
+- `OLLAMA_API_KEY`: For remote Ollama servers requiring authentication
+- Local Ollama typically doesn't require a key
+
+**GitHub**
+- `GITHUB_API_KEY`: For GitHub import/export features
+- Format: `ghp_...` or `github_pat_...`
+- Get from: https://github.com/settings/tokens
+
+## Configuration Priority
+
+Environment variables are processed in this order:
+
+1. **Environment variables** (highest priority)
+2. **`tunacode.json` configuration file**
+3. **Default values** (lowest priority)
+
+Example: If `OPENAI_API_KEY` is set both in `.env` and `tunacode.json`, the `.env` value takes precedence.
+
+## Security Best Practices
+
+### Never Commit `.env` Files
+```bash
+# Add to .gitignore
+.env
+.env.local
+.env.production
+```
+
+### Use Different Files for Different Environments
+```
+.env                # Local development
+.env.staging       # Staging environment
+.env.production    # Production environment
+```
+
+### Secure Storage
+- Use encrypted secrets management in production
+- Consider using `direnv` for automatic environment loading
+- Use `.env.example` as a template for required variables
+
+### Key Rotation
+- Regularly rotate API keys
+- Monitor key usage and billing
+- Revoke compromised keys immediately
+
+## Usage Examples
+
+### Development Setup
+```bash
+# Copy and configure
+cp documentation/configuration/.env.example .env
+echo 'ANTHROPIC_API_KEY="your-key"' >> .env
+
+# Load environment
+source .env
+
+# Run tunacode
+tunacode --model "anthropic:claude-3-sonnet"
+```
+
+### CI/CD Integration
+```yaml
+# GitHub Actions example
+env:
+  ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+  OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+```
+
+### Docker Integration
+```dockerfile
+# Dockerfile
+COPY .env.example .env
+# Build-time or run-time environment injection
+```
+
+## Troubleshooting
+
+### Common Issues
+
+**API Key Not Found**
+```bash
+# Check if variable is set
+echo $ANTHROPIC_API_KEY
+
+# Verify file exists
+ls -la .env
+```
+
+**Invalid API Key Format**
+- Ensure keys start with correct prefix (`sk-`, `pplx-`, etc.)
+- Check for extra spaces or quotes
+- Verify key hasn't expired
+
+**Permission Issues**
+```bash
+# Check file permissions
+chmod 600 .env
+```
+
+### Debug Environment Loading
+```bash
+# Show all environment variables
+env | grep API_KEY
+
+# Test with specific variable
+python -c "import os; print(os.getenv('ANTHROPIC_API_KEY', 'NOT SET'))"
+```
+
+## Integration with Configuration Files
+
+Environment variables can be referenced in `tunacode.json`:
+
+```json
+{
+    "env": {
+        "ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}",
+        "OPENAI_API_KEY": "${OPENAI_API_KEY}"
+    }
+}
+```
+
+This allows for flexible configuration management across different deployment environments.

tunacode_cli-0.0.75/documentation/configuration/tunacode-json-example.md

@@ -0,0 +1,125 @@
+# TunaCode Configuration Example File
+
+The `tunacode.json.example` file provides a comprehensive template for configuring the TunaCode system. This file demonstrates all available configuration options and their default values.
+
+## File Location
+
+The actual configuration file should be located at:
+- **Linux/macOS**: `~/.config/tunacode.json`
+- **Windows**: `%APPDATA%\tunacode.json`
+
+## Configuration Structure
+
+```json
+{
+    "default_model": "openai:gpt-4.1",
+    "env": {
+        "ANTHROPIC_API_KEY": "",
+        "GEMINI_API_KEY": "",
+        "OPENAI_API_KEY": "api-key",
+        "OPENROUTER_API_KEY": "",
+        "OPENAI_BASE_URL": "https://api.cerebras.ai/v1"
+    },
+    "settings": {
+        "max_retries": 10,
+        "max_iterations": 40,
+        "tool_ignore": [
+            "read_file"
+        ],
+        "guide_file": "TUNACODE.md",
+        "fallback_response": true,
+        "fallback_verbosity": "normal",
+        "context_window_size": 200000,
+        "enable_streaming": true,
+        "ripgrep": {
+            "use_bundled": false,
+            "timeout": 10,
+            "max_buffer_size": 1048576,
+            "max_results": 100,
+            "enable_metrics": false,
+            "debug": false
+        },
+        "enable_tutorial": true,
+        "first_installation_date": "2025-09-11T11:50:40.167105",
+        "tutorial_declined": true
+    },
+    "mcpServers": {}
+}
+```
+
+## Configuration Options
+
+### Default Model
+- `default_model`: Default AI model to use (format: `provider:model-name`)
+  - Examples: `openai:gpt-4.1`, `anthropic:claude-3-sonnet`, `google:gemini-pro`
+
+### Environment Variables (`env`)
+Configure API keys and endpoints for different AI providers:
+
+**Required Keys:**
+- `ANTHROPIC_API_KEY`: Anthropic Claude API key (format: `sk-ant-api03-...`)
+- `OPENAI_API_KEY`: OpenAI API key (format: `sk-proj-...`)
+- `OPENROUTER_API_KEY`: OpenRouter API key
+
+**Optional Keys:**
+- `GEMINI_API_KEY`: Google Gemini API key
+- `OPENAI_BASE_URL`: Custom OpenAI-compatible endpoint (e.g., Cerebras, LocalAI)
+
+### Settings
+
+**Core Settings:**
+- `max_retries`: Maximum retry attempts for failed operations (default: 10)
+- `max_iterations`: Maximum agent iterations per request (default: 40)
+- `tool_ignore`: List of tools to disable (e.g., `["read_file"]`)
+- `guide_file`: Project instruction file (default: `TUNACODE.md`)
+- `fallback_response`: Enable fallback when iterations exhausted (default: true)
+- `fallback_verbosity`: Fallback verbosity level (`minimal`, `normal`, `detailed`)
+- `context_window_size`: Maximum context size in tokens (default: 200000)
+- `enable_streaming`: Enable streaming responses (default: true)
+
+**Ripgrep Configuration:**
+- `use_bundled`: Use bundled ripgrep binary (default: false)
+- `timeout`: Ripgrep timeout in seconds (default: 10)
+- `max_buffer_size`: Maximum buffer size in bytes (default: 1048576)
+- `max_results`: Maximum search results (default: 100)
+- `enable_metrics`: Enable ripgrep metrics (default: false)
+- `debug`: Enable debug output (default: false)
+
+**Tutorial Settings:**
+- `enable_tutorial`: Enable first-time tutorial (default: true)
+- `first_installation_date`: Installation timestamp
+- `tutorial_declined`: User has declined tutorial (default: false)
+
+### MCP Servers
+- `mcpServers`: Model Context Protocol server configurations (empty by default)
+
+## Setup Methods
+
+1. **Copy from Example**:
+   ```bash
+   cp documentation/configuration/tunacode.json.example ~/.config/tunacode.json
+   # Edit the file with your API keys
+   ```
+
+2. **Setup Wizard**:
+   ```bash
+   tunacode --setup
+   ```
+
+3. **CLI Configuration**:
+   ```bash
+   tunacode --model "openai:gpt-4.1" --key "your-api-key"
+   ```
+
+## Runtime Configuration Changes
+
+- Change iterations: `/iterations 30`
+- Switch models: `/model`
+- View current config: `/config`
+
+## Security Notes
+
+- Never commit your actual `tunacode.json` file to version control
+- Use environment variables for sensitive keys in production
+- Keep API keys secure and rotate them regularly
+- The example file contains placeholder values only

{tunacode_cli-0.0.73 → tunacode_cli-0.0.75/documentation/configuration}/tunacode.json.example

@@ -1,4 +1,5 @@
 {
+                    #for example we can have the provider:model
     "default_model": "openai:gpt-4.1",
     "env": {
         "ANTHROPIC_API_KEY": "",