Welcome to the Modelling People team organization! This repository serves as the home for our PoPe full-stack application and the shared standards, conventions, and resources that support it.

Our goal is to create a scalable, maintainable, and collaborative environment for development across backend, frontend, AI pipelines, and documentation.

PoPe was built at the ATN + AECTech Hackathon, held at Heatherwick Studio in London in March 2026. The system processes egocentric video captured on-site to estimate body poses and flag potential ergonomic or safety risks in construction environments. It combines AI-driven pose estimation, inverse kinematics, and a streamlined UI into an end-to-end pipeline designed for real-world site analysis.

This organization contains three repositories that together form the project:

• api-inference: Wraps the inference pipeline with FastAPI to provide API endpoints for model interaction.
• egoallo: An iPhone-adjusted version of the original EgoAllo repository for mobile-captured workflows and compatibility.
• frontend: The client application that provides the user-facing interface and experience.

The individual repositories specify their exact stack.

To maintain consistency across the organization, we follow these baseline guidelines:

• Use consistent code formatting (Prettier, ESLint, or language-appropriate formatters/linters)
• Favor clarity over cleverness
• Use TypeScript where possible in frontend/client code
• Keep API contracts explicit and versioned where needed

• Use clear, conventional commit messages (commitizen recommended)
• Prefer a feature-branch workflow and pull requests
• Keep PRs focused and reviewable

• Maintain an up-to-date README
• Include setup steps, environment variables, and common workflows
• Document API endpoints and payload examples when adding/changing routes

Instructions vary by repository, but generally you can:

1. Clone the required repositories
2. Install dependencies
3. Run local development for frontend and backend services

Contributions are welcomed! Please:

• Open an issue before major changes
• Follow repository-specific guidelines
• Keep discussions respectful and collaborative

This project was initially developed with contributions from:

• Axel
• Iliana
• Alfredo
• Konstantina
• Grahesh
• Ayman
• Jeroen
• Gareth
• Kareena

MIT License

For questions, ideas, or suggestions, open a discussion or issue in the appropriate repository.

Welcome aboard! 🎉