IntegraChat / QUICK_PUSH_GUIDE.md
nothingworry's picture
Deploy IntegraChat to Hugging Face Spaces - Full deployment with Docker, MCP server, FastAPI backend, and Gradio UI
852c966
# πŸš€ Quick Guide: Push to Hugging Face Spaces
## ⚠️ The Space doesn't exist yet! Create it first:
### Step 1: Create the Space (2 minutes)
1. **Open your browser** and go to:
```
https://huggingface.co/new-space
```
2. **Fill in the form**:
- **Space name**: `IntegraChat`
- **SDK**: Select **"Docker"** (IMPORTANT!)
- **Hardware**: Choose **"CPU basic"** (free) or upgrade
- **Visibility**: Public or Private
3. **Click "Create Space"**
4. **Wait 10-20 seconds** for the Space to be created
### Step 2: Authenticate (if needed)
If you get authentication errors when pushing, run:
```powershell
huggingface-cli login
```
Enter your token from: https://huggingface.co/settings/tokens
### Step 3: Push Your Code
Once the Space is created, run:
```powershell
git push hf main
```
---
## 🎯 Alternative: Use Token in URL (One-time)
If you prefer to authenticate via token:
1. Get your token: https://huggingface.co/settings/tokens
2. Run this command (replace YOUR_TOKEN):
```powershell
git remote set-url hf https://nothingworry:YOUR_TOKEN@huggingface.co/spaces/nothingworry/IntegraChat
```
3. Then push:
```powershell
git push hf main
```
---
## βœ… After Pushing
1. Go to: https://huggingface.co/spaces/nothingworry/IntegraChat
2. Click **"Settings"** tab
3. Add environment variables in **"Repository secrets"**:
- `POSTGRESQL_URL`
- `OLLAMA_URL` (or `GROQ_API_KEY`)
- `OLLAMA_MODEL`
4. Wait for build (5-10 minutes)
5. Check **"Logs"** tab for progress
---
**Your Space URL**: https://huggingface.co/spaces/nothingworry/IntegraChat