Agent.md

Deployment Agent Instructions

This codebase is configured for deployment on Hugging Face Spaces.

Deployment Configuration

Target Space

• Profile: Leon4gr45
• Space: paper2code-cli
• Full Identifier: Leon4gr45/paper2code-cli
• Frontend Port: 7860

SDK

• SDK: docker

Mandatory Endpoints

• /health: Returns HTTP 200 when ready.
• /api-docs: Documentation of all API endpoints.

HF Space Secrets

To fully configure the application, the following secrets should be set in the Hugging Face Space settings:

• `OPENAI_API_KEY`: Your OpenAI API key.
• `OPENAI_BASE_URL`: (Optional) Custom base URL for OpenAI-compatible APIs.
• `DEFAULT_MODEL`: (Optional) The default model to use (e.g., `openai/gpt-4o`).
• `FIRECRAWL_API_KEY`: Required for web search and scraping.
• `PERSONAL_ACCESS_TOKEN`: GitHub PAT with repo access for pushing code.
• `ANTHROPIC_API_KEY`: (Optional) For Anthropic models.
• `GEMINI_API_KEY`: (Optional) For Google Gemini models.
• `GROQ_API_KEY`: (Optional) For Groq models.

Deployment Workflow

To deploy, use: ```bash hf upload Leon4gr45/paper2code-cli --repo-type=space ```

Monitor logs using:

• Build logs: `curl -N -H "Authorization: Bearer $HF_TOKEN" "https://huggingface.co/api/spaces/Leon4gr45/paper2code-cli/logs/build"\`
• Run logs: `curl -N -H "Authorization: Bearer $HF_TOKEN" "https://huggingface.co/api/spaces/Leon4gr45/paper2code-cli/logs/run"\`