Development Environment Setup

This guide will help you set up your development environment for AIC Holdings data science projects.

Prerequisites

• Python 3.8+ installed
• Git configured with your AIC credentials
• VSCode or preferred IDE

Step 1: Clone the Repository

git clone https://github.com/your-org/data-science.git
cd data-science

Step 2: Set Up Python Environment

We recommend using pyenv for Python version management:

# Install Python 3.12.7 (recommended version)
pyenv install 3.12.7
pyenv local 3.12.7

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Step 3: Install Dependencies

# Install core dependencies
pip install -r requirements.txt

# Install development tools
pip install -r requirements-dev.txt

Step 4: Configure IDE

VSCode Setup

1. Install Python extension
2. Install Claude Code extension
3. Set Python interpreter to your virtual environment
4. Configure linting and formatting

Recommended Extensions

• Python
• Claude Code
• Jupyter
• GitLens
• Python Docstring Generator

Step 5: Verify Installation

Test your setup by running the launcher:

python launch.py

You should see the Streamlit app launcher with available applications.

Next Steps

• Explore the Data Science Education Guide
• Check out existing projects in the apps/ directory
• Join the team chat for questions and support

Pro Tip

Use Claude Code to help you understand and modify existing code. It's particularly helpful for learning our codebase patterns.