Developer Setup Guide

---

Prerequisites

Requirement	Version	Purpose
Python	3.9+	Scripts and tools
pip	Latest	Package management
Git	2.30+	Version control
pdfplumber	Latest	PDF text extraction
GitHub CLI (gh)	2.0+	Issue management and progress tracking

---

Quick Start

1. Clone the Repository

# Primary development (FHGR)
git clone https://git.fhgr.ch/digital-finance/wecan-innosuisse-ai.git
cd wecan-innosuisse-ai

# GitHub mirror (read-only sync)
git clone https://github.com/wecangroup/wecan-innosuisse-ai.git

2. Install Dependencies

pip install pdfplumber

No other Python packages are required for core functionality. The scripts use only the standard library plus pdfplumber for PDF extraction.

3. Verify Installation

# Validate all 24 execution JSON files
python tools/validate_all_months.py

# Expected output: PASSED (0 errors, 0 warnings)

4. Run the Pipeline

# Extract data from PDF application
python scripts/extract_pdf.py

# Generate project plan
python scripts/generate_project_plan.py

# Generate wiki
python scripts/update_wiki.py

# Open wiki in browser
start web/wiki.html    # Windows
open web/wiki.html     # macOS
xdg-open web/wiki.html # Linux

---

Directory Structure

wecan-innosuisse-ai/
├── Application/          # Source Innosuisse application (PDF)
├── data/                 # Generated JSON data
│   ├── extracted_content.json    # PDF extraction output
│   ├── project_plan_data.json    # Structured project plan
│   └── progress_snapshot.json    # GitHub progress data
├── deliverables/         # 19 deliverable templates (D1.1-D5.3)
├── docs/                 # Jekyll documentation site
│   ├── _config.yml       # Jekyll config with nav
│   ├── index.md          # Home page
│   ├── assets/charts/    # 10 chart visualizations
│   └── work-packages/    # WP1-WP5 detail pages
├── execution/            # 24 monthly JSON files (M01-M24)
│   ├── M01_January2026.json - M24_December2027.json
│   ├── schema.json       # JSON schema for validation
│   └── README.md         # Execution file documentation
├── kickoff/              # M1 kickoff materials
├── presentations/        # Beamer slide decks
├── reports/              # Monthly status reports
├── scripts/              # Core pipeline scripts (5)
├── templates/            # Report and presentation templates
├── tools/                # GitHub integration utilities (10 active)
│   └── archive/          # 11 archived tools
└── web/                  # HTML outputs
    ├── wiki.html         # Interactive project wiki
    └── progress.html     # Progress dashboard

---

Core Scripts

Script	Purpose	Run Command
extract_pdf.py	Extract text and tables from Innosuisse PDF	python scripts/extract_pdf.py
generate_project_plan.py	Generate structured project plan from extracted data	python scripts/generate_project_plan.py
generate_execution_jsons.py	Create 24 monthly execution JSON files	python scripts/generate_execution_jsons.py
generate_dashboard.py	Generate interactive execution dashboard HTML	python scripts/generate_dashboard.py
update_wiki.py	Update wiki.html with Project/Plan/Application views	python scripts/update_wiki.py

See Tools Reference for the complete list of all 15 active scripts and tools.

---

Common Tasks

Validate Execution Data

python tools/validate_all_months.py

Checks all 24 JSON files for structural integrity, budget compliance, dependency chains, milestone criteria, and deliverable assignments.

Track Progress from GitHub

# Fetch latest task completion from GitHub issues
python tools/fetch_progress.py

# Generate visual dashboard
python tools/generate_progress_dashboard.py

# View dashboard
start web/progress.html

Generate Monthly Report

# Current month
python tools/generate_monthly_report.py

# Specific month
python tools/generate_monthly_report.py 2

Regenerate All HTML Outputs

python scripts/generate_dashboard.py
python scripts/update_wiki.py
python tools/generate_progress_dashboard.py

---

Environment Variables

Variable	Default	Purpose
GITHUB_REPO	wecangroup/wecan-innosuisse-ai	Repository for GitHub API calls

---

IDE Recommendations

• VS Code with Python extension for script development
• TeXstudio or VS Code LaTeX Workshop for presentation editing
• Markdown preview for documentation editing

---

Troubleshooting

Issue	Solution
ModuleNotFoundError: pdfplumber	Run pip install pdfplumber
gh: command not found	Install GitHub CLI: https://cli.github.com/
JSON validation fails	Ensure execution JSONs match execution/schema.json
Wiki HTML not updating	Re-run python scripts/update_wiki.py

---

See also: Contributing Guide, Onboarding