{"id":17724683,"url":"https://github.com/igrmk/cavez","last_synced_at":"2026-01-25T14:32:03.102Z","repository":{"id":194394727,"uuid":"690747629","full_name":"igrmk/cavez","owner":"igrmk","description":"Conda Automatic Virtual Environments for ZSH","archived":false,"fork":false,"pushed_at":"2024-09-27T16:03:25.000Z","size":30,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-18T17:09:30.929Z","etag":null,"topics":["conda","mamba","micromamba","python","python-virtual-environment","virtual-environment","zsh"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/igrmk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-12T19:45:37.000Z","updated_at":"2024-09-27T16:03:28.000Z","dependencies_parsed_at":"2023-09-13T05:46:07.306Z","dependency_job_id":"f031ec92-6764-46a4-adda-e9e9161709a4","html_url":"https://github.com/igrmk/cavez","commit_stats":{"total_commits":20,"total_committers":1,"mean_commits":20.0,"dds":0.0,"last_synced_commit":"477ed2ddbdfd2c02be5efdcd06d5e22c4fbd34f1"},"previous_names":["igrmk/cavez"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/igrmk/cavez","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igrmk%2Fcavez","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igrmk%2Fcavez/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igrmk%2Fcavez/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igrmk%2Fcavez/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/igrmk","download_url":"https://codeload.github.com/igrmk/cavez/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igrmk%2Fcavez/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28754205,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T13:59:49.818Z","status":"ssl_error","status_checked_at":"2026-01-25T13:59:33.728Z","response_time":113,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["conda","mamba","micromamba","python","python-virtual-environment","virtual-environment","zsh"],"created_at":"2024-10-25T15:48:31.535Z","updated_at":"2026-01-25T14:32:03.083Z","avatar_url":"https://github.com/igrmk.png","language":"Shell","readme":"CAVEZ / Conda Automatic Virtual Environments for Zsh\n====================================================\n\nThis is another tool that automatically switches a Python virtual environment based on the directory you are in.\nThis tool only works if the following assumptions are met:\n  * The virtual environment is stored in the project directory\n  * The virtual environment directory is named either `.venv`\n    or the name you specified in `CAVEZ_VENV_DIR_NAME` environment variable\n\nThis tool works with conda, mamba, and micromamba.\nYou can specify the conda flavor in the `CAVEZ_CONDA_FLAVOUR` environment variable.\nIf this variable is not set, the tool will try to automatically detect which flavor is installed.\n\nWhy another tool?\n\n  * I use Micromamba implementation of Conda, which is rarely supported by other similar tools\n  * I prefer to keep a virtual environment in the project directory,\n    e.g. `micromamba create -p ./.venv`,\n    which is rarely supported by other similar tools as well\n  * This implementation is dead simple\n  * It doesn't override `cd`, which I find clumsy\n\nDependencies\n------------\n\n  * This is a plugin for Oh My Zsh, so the latter should be installed.\n  * Any implementation of Conda should be installed, e.g. Conda itself, Mamba or Micromamba.\n\nInstallation\n------------\n\n[ZPlug](https://github.com/zplug/zplug)\n\n    zplug \"igrmk/cavez\"\n\n[Antigen](https://github.com/zsh-users/antigen)\n\n    antigen bundle \"igrmk/cavez\"\n\n[Zgen](https://github.com/tarjoilija/zgen)\n\n    zgen load \"igrmk/cavez\"\n\n[zinit](https://github.com/zdharma-continuum/zinit)\n\n    zinit wait lucid for igrmk/cavez\n\n[oh-my-zsh](https://github.com/robbyrussell/oh-my-zsh)\n\nCopy this repository to `$ZSH_CUSTOM/plugins`, where `$ZSH_CUSTOM` is the directory with custom plugins of oh-my-zsh\n[(read more)](https://github.com/robbyrussell/oh-my-zsh/wiki/Customization/):\n\n    git clone \"https://github.com/igrmk/cavez.git\" \"$ZSH_CUSTOM/plugins/cavez\"\n\nThen add \"cavez\" to your plugins. For example, add this line to your `.zshrc`. Make sure it is **before** the line\n`source $ZSH/oh-my-zsh.sh`.\n\n    plugins+=(cavez)\n\nManual Installation\n-------------------\n\nSource the plugin shell script in your `~/.zshrc` profile. For example\n\n    source $HOME/cavez/cavez.plugin.zsh\n\nThanks to Michael Aquilina for this project https://github.com/MichaelAquilina/zsh-autoswitch-virtualenv.\nI've just copied installation instructions from it.\n\nConfiguration\n-------------\n\n| Environment variable   | Description                                                              |\n| ---------------------- | ------------------------------------------------------------------------ |\n| `CAVEZ_VENV_DIR_NAME`  | The name of a directory containing a virtual environment                 |\n| `CAVEZ_VERBOSE`        | Report any actions performed by CAVEZ if the value equals \"true\"         |\n| `CAVEZ_SKIP_HOOK_INIT` | Skip the initialization of the hook, this is only for debugging purposes |\n\nPowerlevel10k\n-------------\n\nIf you are using the [Powerlevel10k](https://github.com/romkatv/powerlevel10k) Zsh theme and want to show only the important part of the Conda prefix, you can update your `~/.p10k.zsh` config file.\nOverride the following variable to do it:\n\n    typeset -g POWERLEVEL9K_ANACONDA_CONTENT_EXPANSION='$(\n      if [[ \"${CONDA_DEFAULT_ENV}\" == */.venv ]]; then\n        basename \"${CONDA_DEFAULT_ENV%/.venv}\"\n      else\n        printf \"%s\" \"${CONDA_DEFAULT_ENV}\"\n      fi\n    )'\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figrmk%2Fcavez","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Figrmk%2Fcavez","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figrmk%2Fcavez/lists"}