File size: 1,705 Bytes
8325dd1 cbb7e42 8325dd1 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 | # Hugging Face Spaces Deployment Checklist
## Local Preflight
Run these from the repo root:
```bash
pip install -r requirements.txt
python -m pytest
python app.py
```
Open:
```text
http://127.0.0.1:7860
```
Test a small repo first:
```text
https://github.com/pallets/itsdangerous
```
## Create The Space
1. Go to Hugging Face Spaces.
2. Create a new Space.
3. Choose SDK: `Gradio`.
4. Choose hardware: CPU basic for the mock MVP.
5. Use the AMD hackathon organization if the event requires it.
## Required Files
These must be at the repo root:
```text
app.py
requirements.txt
README.md
```
The README includes the Space metadata:
```yaml
sdk: gradio
sdk_version: 6.14.0
app_file: app.py
```
## Environment Variables
For the public mock demo:
```text
LLM_PROVIDER=mock
```
For a later AMD/vLLM deployment:
```text
LLM_PROVIDER=vllm
LLM_BASE_URL=http://YOUR_VLLM_ENDPOINT/v1
LLM_API_KEY=not-needed-if-your-endpoint-does-not-require-one
LLM_MODEL=Qwen/Qwen2.5-Coder-32B-Instruct
```
## First Hosted Smoke Test
In the deployed Space, test:
```text
https://github.com/pallets/itsdangerous
```
Then test:
```text
https://github.com/psf/requests
```
Expected behavior:
- Crawler maps files.
- Chunker creates chunks.
- Security, Performance, Quality, and Docs agents run.
- Synthesizer returns a report.
- Report shows a prioritized subset while preserving total finding counts.
## If The Space Fails
Check the Space logs first. Common issues:
- Dependency install failure: verify `requirements.txt`.
- App import failure: verify root `app.py`.
- GitHub clone failure: verify Space has outbound internet access.
- Large repo timeout: test `pallets/itsdangerous` before larger repos.
|