Project Setup Guide¶

Overview¶

This guide covers the complete setup process for The Path (AI-Pi) development environment.

Directory Structure¶

thepath-ai_pi/

├── server/                 # Go server

│   ├── cmd/               # Entry points

│   ├── internal/          # Internal packages

│   ├── pkg/               # Public packages

│   └── go.mod            # Go dependencies

├── client/                # TypeScript client

│   ├── src/              # Source code

│   ├── public/           # Static assets

│   └── package.json      # Node dependencies

├── ai/                    # Python AI system

│   ├── models/           # AI models

│   ├── training/         # Training system

│   └── requirements.txt  # Python dependencies

├── docs/                 # Documentation

├── scripts/              # Build/deploy scripts

└── docker/               # Docker configs

Prerequisites¶

Hardware Requirements¶

Raspberry Pi 5 (8GB RAM recommended)
AI HAT+ module
Active cooling solution
MicroSD card (32GB+ recommended)
Optional: 7-inch touchscreen

Software Requirements¶

Go 1.21+
Node.js 20+
Python 3.11+
Docker & Docker Compose
Git

Development Environment Setup¶

1. System Setup¶

# Update system

sudo apt update && sudo apt upgrade -y

# Install system dependencies

sudo apt install -y \

    build-essential \

    python3-dev \

    python3-pip \

    nodejs \
    npm \
    docker.io \
    docker-compose

# Enable Docker

sudo systemctl enable docker
sudo systemctl start docker
sudo usermod -aG docker $USER

2. Go Setup¶

# Install Go

wget https://go.dev/dl/go1.21.5.linux-arm64.tar.gz

sudo tar -C /usr/local -xzf go1.21.5.linux-arm64.tar.gz

# Add to PATH

echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc

# Verify installation

go version

3. Node.js Setup¶

# Install Node.js LTS

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

sudo apt install -y nodejs

# Install development tools

npm install -g typescript ts-node nodemon

# Verify installation

node --version

npm --version

4. Python Setup¶

# Create virtual environment

python3 -m venv venv

source venv/bin/activate

# Install dependencies

pip install -r ai/requirements.txt

# Verify installation

python --version

pip list

5. AI HAT+ Setup¶

# Install AI HAT+ drivers

curl -sSL https://raw.githubusercontent.com/arducam/arducam-config-parser-dev/master/install.sh | sudo bash

# Configure I2C

sudo raspi-config nonint do_i2c 0

# Test HAT+ connection

i2cdetect -y 1

Project Setup¶

1. Clone Repository¶

# Clone project

git clone https://github.com/MaterDev/thepath-ai_pi.git

cd thepath-ai_pi

# Initialize git hooks

./scripts/init-hooks.sh

2. Server Setup¶

# Build server

cd server
go mod download
go build ./cmd/server

# Run tests

go test ./...

3. Client Setup¶

# Install dependencies

cd client
npm install

# Build client

npm run build

# Run tests

npm test

4. AI System Setup¶

# Setup AI environment

cd ai
python -m venv venv

source venv/bin/activate
pip install -r requirements.txt

# Run tests

python -m pytest

5. Development Database¶

# Start MongoDB

docker-compose -f docker/docker-compose.dev.yml up -d

# Verify connection

mongo mongodb://localhost:27017

Running the Project¶

Development Mode¶

# Terminal 1: Run server

cd server
go run ./cmd/server

# Terminal 2: Run client

cd client
npm run dev

# Terminal 3: Run AI system

cd ai
source venv/bin/activate
python -m ai.main

Production Mode¶

# Build and run with Docker

docker-compose up --build

Common Issues¶

1. Hardware Access¶

If you encounter permission issues with AI HAT+:

# Add user to required groups

sudo usermod -aG gpio,i2c $USER

# Reload groups

newgrp gpio
newgrp i2c

2. Memory Management¶

If you encounter memory issues:

# Adjust swap size

sudo dphys-swapfile swapoff

sudo nano /etc/dphys-swapfile

# Set CONF_SWAPSIZE=2048

sudo dphys-swapfile setup

sudo dphys-swapfile swapon

3. Performance Optimization¶

For optimal performance:

# Enable performance governor

echo "performance" | sudo tee /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor

# Monitor temperature

vcgencmd measure_temp

Development Tools¶

1. VSCode Setup¶

Recommended extensions:

Go
Python
TypeScript
Docker
Remote - SSH

2. Git Configuration¶

# Configure Git

git config --global user.name "Your Name"

git config --global user.email "your.email@example.com"

# Setup pre-commit hooks

pre-commit install

3. Testing Tools¶

# Install testing tools

go install github.com/golang/mock/mockgen@v1.6.0
npm install -g jest

pip install pytest pytest-cov

Monitoring¶

Setup progress
Build status
Test coverage
Deployment health