NUNA/guidebook/07_quick_start.md

Quick Start Guide - NUNA Tools

✅ Installation Status

Run this to verify packages are installed:

python -c "import google.auth; import msal; import requests; print('All packages OK!')"

🚀 Quick Setup

Option 1: Use Interactive Scripts (Recommended)

Google Drive Setup:

.\setup-google-oauth.ps1

OneDrive Setup:

.\setup-onedrive-oauth.ps1

Option 2: Manual Setup

See SETUP-OAUTH.md for detailed step-by-step instructions.

---

📋 Google Drive Cleanup

First Time Setup:

1. Run: .\setup-google-oauth.ps1
2. Follow the prompts to download credentials.json
3. Test: python gdrive_cleanup.py audit --top 5

Common Commands:

Audit - Find largest files:

python gdrive_cleanup.py audit --top 25 --show-links

Export full inventory:

python gdrive_cleanup.py audit --csv gdrive-report.csv --json gdrive-report.json

Find duplicates:

python gdrive_cleanup.py duplicates --show 20 --show-per-group 10

Trash files (dry-run first!):

# 1. Create ids_to_trash.json with file IDs
# 2. Dry-run:
python gdrive_cleanup.py trash --ids-json ids_to_trash.json --confirm "TRASH 2 FILES"
# 3. Apply (actually trash):
python gdrive_cleanup.py trash --ids-json ids_to_trash.json --confirm "TRASH 2 FILES" --apply

---

📋 Dropbox to OneDrive Import

First Time Setup:

1. Run: .\setup-onedrive-oauth.ps1
2. Enter your Azure Client ID when prompted
3. Test: python dropbox_to_onedrive.py --dropbox-url "YOUR_URL" --dry-run

Common Commands:

Dry-run (preview only):

python dropbox_to_onedrive.py --dropbox-url "<DROPBOX_SHARED_FOLDER_URL>" --dry-run

Import to OneDrive:

python dropbox_to_onedrive.py --dropbox-url "<DROPBOX_SHARED_FOLDER_URL>" --onedrive-folder "Dropbox Import"

---

📈 Trading Data File Management (Local)

This repo also includes a safe-by-default local automation helper for trading logs/exports/reports:

• Script: trading_data_manager.py
• Guide: guidebook/05_trading_data_file_management.md

Initialize folders + write example config:

python3 trading_data_manager.py init --write-example-config trading_data_config.example.json

Daily run (dry-run first):

python3 trading_data_manager.py run

Apply (moves/converts files):

python3 trading_data_manager.py run --apply

---

🔧 Troubleshooting

Packages Not Installed?

python -m pip install -r requirements.txt

Google OAuth Issues?

• Check credentials.json exists in J:\NUNA
• Verify Google Drive API is enabled in Google Cloud Console
• Check OAuth consent screen is configured

OneDrive OAuth Issues?

• Verify ONEDRIVE_CLIENT_ID environment variable is set:

  echo $env:ONEDRIVE_CLIENT_ID
  

• If empty, run .\setup-onedrive-oauth.ps1 again
• Restart terminal after setting permanent environment variable

Need Help?

• See SETUP-OAUTH.md for detailed OAuth setup
• Check README.md for full documentation
• Review guidebook/ folder for detailed guides

---

📁 File Structure

J:\NUNA\
├── gdrive_cleanup.py          # Google Drive cleanup tool
├── dropbox_to_onedrive.py     # Dropbox to OneDrive importer
├── requirements.txt           # Python dependencies
├── credentials.json           # Google OAuth (create this)
├── token.json                 # Google auth token (auto-generated)
├── setup-google-oauth.ps1     # Google OAuth setup helper
├── setup-onedrive-oauth.ps1   # OneDrive OAuth setup helper
├── SETUP-OAUTH.md            # Detailed OAuth setup guide
├── QUICK-START.md            # This file
└── guidebook/                # Detailed documentation

---

🎯 Next Steps

1. ✅ Packages installed
2. ⏳ Set up Google OAuth: .\setup-google-oauth.ps1
3. ⏳ Set up OneDrive OAuth: .\setup-onedrive-oauth.ps1
4. 🚀 Start using the tools!