docs/UPDATE_REMOTE.md

How to Update Remote Origin

Method 1: Change Existing Remote URL (Recommended)

If you already have a remote set and want to change it:

# View current remote
git remote -v

# Option A: Update with HTTPS URL
git remote set-url origin https://github.com/YOUR_USERNAME/YOUR_REPO_NAME.git

# Option B: Update with SSH URL
git remote set-url origin git@github.com:YOUR_USERNAME/YOUR_REPO_NAME.git

# Verify the change
git remote -v

---

Method 2: Remove and Re-add Remote

If you want to completely remove and add a new remote:

# Remove existing remote
git remote remove origin

# Add new remote
git remote add origin https://github.com/YOUR_USERNAME/YOUR_REPO_NAME.git

# Verify
git remote -v

---

Method 3: Using Your GitHub Repository

Step 1: Create Repository on GitHub

1. Go to https://github.com/new
2. Repository name: RAG-Capstone-Project
3. Description: Retrieval-Augmented Generation system with TRACE evaluation
4. Select Public or Private
5. IMPORTANT: Don't initialize with README, .gitignore, or license
6. Click "Create repository"

Step 2: Copy Your Repository URL

After creating, GitHub will show you the URL. Copy it (should look like):

https://github.com/YOUR_USERNAME/RAG-Capstone-Project.git

Step 3: Update Remote in Your Local Repository

cd "D:\CapStoneProject\RAG Capstone Project"

git remote set-url origin https://github.com/YOUR_USERNAME/RAG-Capstone-Project.git

# Verify
git remote -v

---

Complete Step-by-Step Example

Let's say your GitHub username is john-doe:

# 1. Navigate to project
cd "D:\CapStoneProject\RAG Capstone Project"

# 2. Update the remote URL
git remote set-url origin https://github.com/john-doe/RAG-Capstone-Project.git

# 3. Verify it was updated
git remote -v

# 4. Push to GitHub (first time)
git push -u origin main

# 5. For future pushes (just use)
git push

---

Using SSH Instead of HTTPS

Step 1: Generate SSH Key (if you don't have one)

ssh-keygen -t ed25519 -C "your_email@example.com"

Step 2: Add SSH Key to GitHub

1. Copy the public key: cat ~/.ssh/id_ed25519.pub
2. Go to https://github.com/settings/keys
3. Click "New SSH key"
4. Paste your public key
5. Save

Step 3: Update Remote to SSH

git remote set-url origin git@github.com:YOUR_USERNAME/RAG-Capstone-Project.git

# Verify
git remote -v

# Test connection
ssh -T git@github.com

---

Troubleshooting

Problem: "fatal: remote origin already exists"

# Remove the old remote first
git remote remove origin

# Then add the new one
git remote add origin https://github.com/YOUR_USERNAME/RAG-Capstone-Project.git

Problem: "Permission denied (publickey)"

This means SSH authentication failed. Use HTTPS instead:

git remote set-url origin https://github.com/YOUR_USERNAME/RAG-Capstone-Project.git

Problem: "fatal: Authentication failed"

This means your GitHub credentials are incorrect. Use a Personal Access Token:

1. Generate token: https://github.com/settings/tokens
2. When pushing, use the token as password

Check Current Configuration

# View remote URLs
git remote -v

# View detailed remote info
git remote show origin

# View git config
git config --local -l

---

Quick Reference

Task	Command
View remotes	git remote -v
Update URL (HTTPS)	git remote set-url origin https://github.com/USER/REPO.git
Update URL (SSH)	git remote set-url origin git@github.com:USER/REPO.git
Remove remote	git remote remove origin
Add remote	git remote add origin <URL>
Push to remote	git push -u origin main
Check remote details	git remote show origin

---

What You Need to Push

Before pushing, make sure you have:

• ✅ GitHub account created
• ✅ Repository created on GitHub
• ✅ Remote URL updated correctly
• ✅ Local commits ready (already done ✓)

---

What's your GitHub username? I can help you with the exact commands once you provide it!