virtualenvwrapper.project plugin to create github projects automatically. [UPDATED TO SUPPORT APIv3]
Switch branches/tags
Nothing to show
Pull request Compare This branch is 6 commits ahead of mattoufoutu:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


virtualenvwrapper.github is a template for virtualenvwrapper.project (by Doug Hellmann). It automaticaly creates a GitHub repository for the new project, initializes the local repository and configures the remote origin. If the GitHub repository already exists, user will be prompted to clone the repository or abort the operation.


The following python packages need to be installed and can be downloaded from pypi:

  • virtualenv
  • virtualenvwrapper (>=2.0)
  • virtualenvwrapper.project (>=1.0)
  • PyGithub
  • gitpython


Download the latest project version, put yourself in the source directory, and as root, type:

python install

Then, you need to set your GitHub username and api key, you can find your api key in your account settings, under the administration tab. Add these two lines to your .bashrc (or .zshrc or whatever your shell is)

export GITHUB_USER="username"
export GITHUB_API_TOKEN="api_token"


Just specify 'github' as a template to use when launching the mkproject command:

mkproject -t github my_project_name

Enter your project description and homepage if you want, and you're good to go.