stack/docs/archive/PUSH_GUIDE.md

🚀 Pushing to GitHub (my-ai-stack/stack-2.9)

This guide walks through creating the repository on GitHub and pushing the local code.

Prerequisites

• You have a GitHub account with admin access to the my-ai-stack organization
• Git is installed locally
• You have configured SSH or HTTPS credentials for GitHub

Steps

1. Create the Repository on GitHub

Option A: Via Web Interface

1. Go to https://github.com/organizations/my-ai-stack/repositories/new
2. Repository name: stack-2.9
3. Description: "Open-source voice-enabled AI coding assistant based on Qwen2.5-Coder-32B"
4. Choose:
   • ☑ Public (recommended for open source)
   • ☐ Private (if you want to restrict access)
   • ☑ Initialize with a README? NO (we already have one)
5. Click "Create repository"

Option B: Via GitHub CLI (if you have gh installed)

gh repo create my-ai-stack/stack-2.9 \
  --public \
  --description "Open-source voice-enabled AI coding assistant based on Qwen2.5-Coder-32B" \
  --source . \
  --remote origin

2. Connect Local Repository to GitHub

From the stack-2.9 directory:

cd /Users/walidsobhi/.openclaw/workspace/stack-2.9

# If you used Option B above, this is already done. For Option A:
git init
git add .
git commit -m "feat: initial Stack 2.9 release

- Training pipeline with LoRA fine-tuning
- vLLM deployment with Docker
- Voice integration module
- Evaluation suite with benchmarks
- 519 training examples with advanced patterns
- Complete documentation and CI/CD"

# Add GitHub remote (replace with your actual repo URL)
git remote add origin https://github.com/my-ai-stack/stack-2.9.git

# Or via SSH (if you have SSH keys set up):
# git remote add origin git@github.com:my-ai-stack/stack-2.9.git

3. Push to GitHub

# Push main branch
git branch -M main
git push -u origin main

# Push all tags (if any)
git push --tags

4. Verify

Visit: https://github.com/my-ai-stack/stack-2.9

You should see all files:

• README.md with badges
• All subdirectories (training, deploy, voice, docs, eval)
• Documentation
• Makefile for easy builds

5. Post-Push Setup (Optional but Recommended)

Enable GitHub Pages (for docs)

1. Go to repo Settings → Pages
2. Source: "GitHub Actions" or "main branch /docs folder"
3. Save → docs will be at https://my-ai-stack.github.io/stack-2.9/

Add Repository Topics

Add these topics to improve discoverability:

• ai, llm, coding-assistant, voice, open-source, qwen, vllm, fine-tuning, training-data, huggingface, openrouter

Configure Repository Features

• Settings → Features → enable Discussions, Projects, Wiki as needed

Set Up GitHub Actions Secrets (if needed)

If CI/CD needs additional secrets (like Hugging Face token):

1. Settings → Secrets and variables → Actions
2. Add:
   • HF_TOKEN - Hugging Face API token
   • OPENROUTER_API_KEY - OpenRouter API key (for testing)

Add Collaborators

Invite team members:

• Settings → Collaborators and teams → Add people

6. Update OpenRouter Submission

In stack-2.9-docs/OPENROUTER_SUBMISSION.md, update:

• Repository URL: https://github.com/my-ai-stack/stack-2.9
• Date of submission
• Point of contact

Email the submission to OpenRouter or submit via their form.

7. Share with Community

Once pushed:

• Announce on Discord/Twitter/LinkedIn
• Submit to Hacker News, r/MachineLearning, etc.
• Engage with Hugging Face community
• Reach out to OpenRouter for listing

Troubleshooting

Error: remote: Repository not found.

• Check you have permission to create repos in my-ai-stack org
• Verify you're using the correct org name
• Try SSH instead of HTTPS

Error: remote: Permission to my-ai-stack/stack-2.9.git denied

• You need admin access to the org
• Contact org admin to grant permissions

Large files failing to push

• Training data might be too large (~100MB+)
• Consider using Git LFS for large files:

  git lfs install
  git lfs track "training-data/advanced-patterns/*.jsonl"
  git add .gitattributes
  

Hitting GitHub rate limits

• Use SSH instead of HTTPS
• Authenticate properly with gh CLI

Next Steps After Push

1. ✅ Create GitHub repo and push code
2. ✅ Enable issues, discussions, wiki
3. ▶️ Start training on GPU (if available)
4. ▶️ Push trained model to Hugging Face
5. ▶️ Submit to OpenRouter
6. ▶️ Create community (Discord)
7. ▶️ Iterate on training data and evaluation

---

Ready? Run the git commands above and let me know if you hit any issues!