Skip to main content

Experience better workflow with google colab, local jupyter notebooks and git

Project description

Welcome to colab-cli 👋

License: MIT Twitter: aks2899

Experience better workflow with google colab, local jupyter notebooks and git

You can now easily manage working with jupyter notebooks and google colab from cli.


  • 🤠 Upload local jupyter notebook to gdrive from cli
  • 😮 Quick access to jupyter notebooks in gdrive from your cli
  • 🚀 Keeps jupyter notebooks organized in gdrive by creating local file structure in gdrive
  • 🤯 Sync local work on notebooks with gdrive
  • 🥂 Git friendly, pull changes from gdrive and commit to git

✨ Demo



pip3 install colab-cli



First we need to get your client_secrets.json file for OAuth2.0 authentication for Drive API,

  1. Go to APIs Console and make your own project.

  2. Search for ‘Google Drive API’, select the entry, and click ‘Enable’.

  3. Select ‘Credentials’ from the left menu, click ‘Create Credentials’, select ‘OAuth client ID’.

  4. Now, the product name and consent screen need to be set -> click ‘Configure consent screen’ and follow the instructions. Once finished:

    a. Select ‘Application type’ to be Web application.

    b. Enter an appropriate name.

    c. Input http://localhost:8080 for ‘Authorized JavaScript origins’.

    d. Input http://localhost:8080/ for ‘Authorized redirect URIs’.

    e. Click ‘Save’.

  5. Click ‘Download JSON’ on the right side of Client ID to download client_secret_<really long ID>.json.

  6. Rename the file to “client_secrets.json” and place it in any directory.


Go to the local directory with client_secrets.json

colab-cli set-config client_secrets.json


Now we need to set the google account user id, goto your browser and see how many google logins you have, the count start from zero

for eg. I have 3 login and I use the second one for coding work, so my user id is 1

colab-cli set-auth-user 1

🙌 Now You're all set to go


colab-cli --help
  • List local ipynb
colab-cli list-nb

NOTE : Please work with git repo initialized, else below commands will not work

  • Open local ipynb file in google colab for first time

Note: It opens the copy of file in gdrive from second time onwards.

colab-cli open-nb lesson1-pets.ipynb
  • If you need to get modified ipynb from gdrive local directory use
colab-cli pull-nb lesson1-pets.ipynb
  • Made some changes to ipynb locally, push it to gdrive
colab-cli push-nb lesson1-pets.ipynb


👤 Akshay Ashok

🤝 Contributing

Contributions, issues and feature requests are welcome!

Feel free to check issues page. You can also take a look at the contributing guide.

Show your support

Give a 🌟 if this project helped you!

📝 License

Copyright © 2020 Akshay Ashok.

This project is MIT licensed.

This README was generated with ❤ by readme-md-generator

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

colab-cli-2.2.2.tar.gz (7.8 kB view hashes)

Uploaded source

Built Distribution

colab_cli-2.2.2-py3-none-any.whl (10.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page