Skip to content

Add developer setup guide for Mac Apple Silicon - #1

Draft
simoncht with Copilot wants to merge 3 commits into
mainfrom
copilot/new-machine-setup-guide
Draft

Add developer setup guide for Mac Apple Silicon#1
simoncht with Copilot wants to merge 3 commits into
mainfrom
copilot/new-machine-setup-guide

Conversation

Copilot AI commented Dec 18, 2025

Copy link
Copy Markdown

New developer onboarding guide for setting up the RAG Transcript System on MacBook with Apple Silicon.

Changes

  • SETUP.md - Comprehensive step-by-step guide covering:

    • Prerequisites (Homebrew, Git, Docker Desktop, Node.js via nvm)
    • Backend setup with Docker Compose (6 containers)
    • Frontend setup with npm
    • Verification steps
    • Optional Ollama setup for local LLM
    • Apple Silicon-specific troubleshooting (Docker resource allocation, Rosetta, common issues)
  • README.md - Added reference to SETUP.md in Development and Documentation sections

Quick Start Preview

# Prerequisites
brew install git
# Install Docker Desktop (Apple Silicon version)
nvm install 18

# Backend
docker compose up -d
docker compose exec app alembic upgrade head
curl http://localhost:8000/health

# Frontend
cd frontend && npm install && npm run dev
Original prompt

i am a new developer and i want to pull this request into my mac book m5. this is a new machine. what do i need to do and what are the steps by step guide?


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot AI and others added 2 commits December 18, 2025 03:28
Co-authored-by: simoncht <26563742+simoncht@users.noreply.github.com>
Co-authored-by: simoncht <26563742+simoncht@users.noreply.github.com>
Copilot AI changed the title [WIP] Add steps for setting up a new development machine Add developer setup guide for Mac Apple Silicon Dec 18, 2025
Copilot AI requested a review from simoncht December 18, 2025 03:30
@simoncht

Copy link
Copy Markdown
Owner

@copilot did you write anything to setup.md?

Copilot AI commented Dec 18, 2025

Copy link
Copy Markdown
Author

@copilot did you write anything to setup.md?

Yes, I created a comprehensive setup guide in SETUP.md (387 lines). It covers:

  • Prerequisites: Homebrew, Git, Docker Desktop for Mac (with Apple Silicon settings), Node.js via nvm
  • Clone & Backend Setup: Docker Compose, storage directories, environment variables, database migrations
  • Frontend Setup: npm install, environment variables, dev server
  • Verification Steps: Health checks and testing video ingestion
  • Optional Ollama Setup: For local LLM
  • Troubleshooting: Apple Silicon-specific issues, common problems, and useful commands

The guide was added in commit 584c969 with a follow-up fix in 1a5ea6f to address code review feedback.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants