---

name: colab-unzip-workflow description: "Colab file paths after unzipping repo. Trigger when: (1) API key file not found, (2) file path errors in Colab, (3) configuring notebook paths, (4) 'yfinance fallback' despite keys existing." author: Claude Code date: 2024-12-28

Colab Unzip Workflow - File Paths

Critical Information

When you unzip Alpaca_trading.zip in Colab, the files are at:

Copy/content/Alpaca_trading/

NOT on Google Drive. NOT at /content/drive/MyDrive/.

API Key Files in This Repo

The repo contains these API key files:

Copy/content/Alpaca_trading/API_key_500Paper.txt   # 500 paper account
/content/Alpaca_trading/API_key_100kPaper.txt  # 100k paper account

NOT API_key.txt. The files have specific names.

Correct Default in training.ipynb

Copy# Cell 15 - CORRECT
API_KEYS_FILE = '/content/Alpaca_trading/API_key_500Paper.txt'

# WRONG - file doesn't exist at this path
API_KEYS_FILE = '/content/drive/MyDrive/API_key.txt'

# WRONG - file name is wrong
API_KEYS_FILE = '/content/Alpaca_trading/API_key.txt'

Failed Attempts (Critical)

Colab Directory Structure After Unzip

Copy/content/
├── Alpaca_trading/              # Unzipped repo
│   ├── API_key_500Paper.txt     # API keys (500 paper)
│   ├── API_key_100kPaper.txt    # API keys (100k paper)
│   ├── notebooks/
│   │   └── training.ipynb
│   ├── alpaca_trading/
│   │   └── ...
│   └── ...
├── drive/                       # Google Drive (if mounted)
│   └── MyDrive/
│       └── ...                  # User's Drive files
└── sample_data/                 # Colab default

How to Verify in Colab

Copyimport os

# Check what's in /content/
print(os.listdir('/content/'))
# Should show: ['Alpaca_trading', 'drive', 'sample_data']

# Check API key files
print(os.listdir('/content/Alpaca_trading/'))
# Should show: API_key_500Paper.txt, API_key_100kPaper.txt, etc.

# Verify file exists
api_path = '/content/Alpaca_trading/API_key_500Paper.txt'
print(f"File exists: {os.path.exists(api_path)}")

Key Rules

1. After unzip: /content/Alpaca_trading/ - not Drive
2. Check actual filenames - don't assume API_key.txt
3. Use absolute paths - relative paths break in Colab
4. Verify before assuming - os.path.exists() is your friend

Files Modified

Copynotebooks/training.ipynb:
  - Cell 15: API_KEYS_FILE = '/content/Alpaca_trading/API_key_500Paper.txt'

References

• Skill: data-source-priority - Why Alpaca API matters
• alpaca_trading/data/fetcher.py - Key loading logic with logging