Google Drive¶

Install¶

pip install nexus-fs[gdrive]

This installs google-api-python-client and google-auth-oauthlib.

Credential setup¶

Google Drive requires OAuth authentication. You need a Google Cloud project with the Drive API enabled and OAuth 2.0 credentials.

Step 1: Create OAuth credentials¶

1. Go to the Google Cloud Console
2. Create a project (or select an existing one)
3. Enable the Google Drive API
4. Go to APIs & Services > Credentials
5. Create an OAuth 2.0 Client ID (type: Desktop app)
6. Note the Client ID and Client Secret

Step 2: Set environment variables¶

export NEXUS_OAUTH_GOOGLE_CLIENT_ID="your-client-id.apps.googleusercontent.com"
export NEXUS_OAUTH_GOOGLE_CLIENT_SECRET="your-client-secret"

Step 3: Connect your account¶

nexus-fs auth connect google-drive oauth --user-email you@example.com

This starts the OAuth flow:

1. Opens your browser to Google's consent screen
2. You authorize nexus-fs to access your Drive files
3. Tokens are encrypted and stored locally at ~/.nexus/

Step 4: Verify¶

nexus-fs auth test google-drive --user-email you@example.com

Or check everything at once:

nexus-fs doctor

Disconnect¶

To remove stored credentials:

nexus-fs auth disconnect google-drive

Mount¶

# skip-test
import nexus.fs

fs = nexus.fs.mount_sync("gdrive://my-drive")

Common patterns¶

List files in Drive¶

# skip-test
import nexus.fs

fs = nexus.fs.mount_sync("gdrive://my-drive")

# List root
files = fs.ls("/gdrive/my-drive/")
for f in files:
    print(f)

Read a file¶

# skip-test
import nexus.fs

fs = nexus.fs.mount_sync("gdrive://my-drive")

content = fs.read("/gdrive/my-drive/notes.txt")
print(content.decode())

Write a file¶

# skip-test
import nexus.fs

fs = nexus.fs.mount_sync("gdrive://my-drive")

fs.write("/gdrive/my-drive/output.txt", b"Generated by nexus-fs")

Auth commands reference¶

Environment variables¶

See also the nexus-fs doctor for diagnostic output.