{"id":19215184,"url":"https://github.com/mamba-org/vscode-micromamba","last_synced_at":"2025-04-06T04:08:36.146Z","repository":{"id":39731855,"uuid":"329724667","full_name":"mamba-org/vscode-micromamba","owner":"mamba-org","description":"A VSCode extension to generate development environments using micromamba and conda-forge package repository","archived":false,"fork":false,"pushed_at":"2025-02-11T01:47:20.000Z","size":2246,"stargazers_count":93,"open_issues_count":3,"forks_count":13,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-03-30T03:03:19.556Z","etag":null,"topics":["conda","conda-forge","mamba","micromamba","vscode-extension"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mamba-org.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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":"2021-01-14T20:18:30.000Z","updated_at":"2025-03-23T09:46:39.000Z","dependencies_parsed_at":"2024-08-06T11:53:03.164Z","dependency_job_id":"a9359842-2f0b-4067-b963-05cf507bbbd4","html_url":"https://github.com/mamba-org/vscode-micromamba","commit_stats":{"total_commits":118,"total_committers":8,"mean_commits":14.75,"dds":"0.30508474576271183","last_synced_commit":"65218cedb6be76421ff48e2713c60b95d9bc4cf5"},"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mamba-org%2Fvscode-micromamba","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mamba-org%2Fvscode-micromamba/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mamba-org%2Fvscode-micromamba/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mamba-org%2Fvscode-micromamba/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mamba-org","download_url":"https://codeload.github.com/mamba-org/vscode-micromamba/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247430868,"owners_count":20937874,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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","conda-forge","mamba","micromamba","vscode-extension"],"created_at":"2024-11-09T14:12:56.442Z","updated_at":"2025-04-06T04:08:36.018Z","avatar_url":"https://github.com/mamba-org.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# vscode-micromamba\n\n[![Build Status](https://github.com/mamba-org/vscode-micromamba/workflows/ci/badge.svg?branch=main)](https://github.com/mamba-org/vscode-micromamba/tree/main) [![Coverage Status](https://coveralls.io/repos/github/mamba-org/vscode-micromamba/badge.svg?branch=main)](https://coveralls.io/github/mamba-org/vscode-micromamba?branch=main) [![Visual Studio Marketplace](https://img.shields.io/visual-studio-marketplace/v/corker.vscode-micromamba?color=success\u0026label=Visual%20Studio%20Marketplace)](https://marketplace.visualstudio.com/items?itemName=corker.vscode-micromamba) [![Open VSX Version](https://img.shields.io/open-vsx/v/corker/vscode-micromamba?label=Open%20VSX%20Registry\u0026color=success)](https://open-vsx.org/extension/corker/vscode-micromamba)\n\n\n\n---\n\nContent\n\n- [vscode-micromamba](#vscode-micromamba)\n  - [The Aim](#the-aim)\n  - [Commands](#commands)\n  - [Global home directory](#global-home-directory)\n  - [DotEnv file support](#dotenv-file-support)\n  - [Multi-root workspaces](#multi-root-workspaces)\n  - [How to get it?](#how-to-get-it)\n  - [Maintainers](#maintainers)\n  - [Want to Contribute?](#want-to-contribute)\n  - [License](#license)\n\n---\n\n## The Aim\n\nProvide a convenient way to install developer tools in VSCode workspaces from [conda-forge](https://conda-forge.org) with [micromamba](https://mamba.readthedocs.io). Get NodeJS, Go, Rust, Python, or JupyterLab installed by running a single command.\n\nInspired by [Robocorp](https://robocorp.com) RPA developer tools:\n\n- [RCC](https://robocorp.com/docs/rcc/overview) - a command-line tool to run software robots and integrate with the Robocorp Cloud\n- [Robocorp Code](https://robocorp.com/docs/developer-tools/visual-studio-code/overview) - a VSCode extension to build software robots\n\n## Commands\n\n### Micromamba: create an environment\n\nThis command creates a file - environment.yml describing configuration.\nThe environment.yml is a [mamba environment file](https://mamba.readthedocs.io/en/latest/user_guide/micromamba.html#yaml-spec-files)\nThe extension comes with a number of templates, but you could change it to your needs and re-run the init command.\n\n1. Open the command palette (Ctrl+Shift+P)\n2. Type - micromamba create environment\n3. Choose a template from a list\n4. The environment is activated automatically\n\n### Micromamba: deactivate the environment\n\n1. Open the command palette (Ctrl+Shift+P)\n2. Type - micromamba deactivate environment\n\n### Micromamba: activate environment\n\n1. Open the command palette (Ctrl+Shift+P)\n2. Type - micromamba activate environment\n3. Choose an environment from a list of created environments\n\n### Micromamba: remove the environment\n\n1. Open the command palette (Ctrl+Shift+P)\n2. Type - micromamba remove environment\n3. Choose an environment from a list of created environments\n\n### Micromamba: clear all\n\nClear all command, removes micromamba and packages, and reset the environment to the initial state.\n\n1. Open the command palette (Ctrl+Shift+P)\n2. Type - micromamba clear all\n\n### Micromamba: activate environment by path\n\nActivate an environment created outside of the _vscode-micromamba_ extension.\n\n1. Open the command palette (Ctrl+Shift+P)\n2. type - micromamba activate by path\n\n### Micromamba: use the global home directory\n\nStore micromamba files and environments for all projects in one global directory.\n\n1. Open the command palette (Ctrl+Shift+P)\n2. Type - micromamba use global home directory\n\n### Micromamba: use the local home directory\n\nStore micromamba files and environments in the .micromamba directory inside the project.\n\n1. Open the command palette (Ctrl+Shift+P)\n2. Type - micromamba use local home directory\n\n\u003e This is a default behavior\n\n### Micromamba: self-update\n\nUpdate micromamba to the latest version.\n\n1. Open the command palette (Ctrl+Shift+P)\n2. Type - micromamba self update\n\n\u003e Micromamba updates each time before creating a new environment\n\n### Micromamba: show output\n\nShow output pane and select micromamba source\n\n1. Open the command palette (Ctrl+Shift+P)\n2. Type - micromamba show output\n\n## Global home directory\n\nThe extension works locally by default when all additional files are created in the `\u003cworkspaceRoot\u003e/.micromamba` directory.\nSwitching to global home directory mode is also possible when files for all projects are stored in one place.\n\n### Local mode\n\n1. A fully encapsulated installation per project - all files are inside the project directory\n2. Nothing left behind when the project gets deleted\n3. Easy to investigate the content of the micromamba environments\n\n### Global mode\n\n1. Use less disk space and could be faster to create environments because packages are cached globally\n2. Micromamba files inside the project directory could conflict with other tools. E.g., `yarn` doesn't like local mode in combination with the `module` node package type.\n\n### Location of the global home directory\n\nOn Linux and Mac, the global home directory is always `$HOME/.vscode-micromamba`\n\nOn Windows, the extension asks to provide a path to the global home directory.\nIt's recommended to make the path as short as possible to minimize [MAX_PATH problems](https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=registry), especially when using Python.\n\n## DotEnv file support\n\nDotEnv file is a convenient way to provide environment variables to other extensions or user scripts.\nEach time a user creates or activates an environment, a ~/.micromamba/.env.{prefix-name} file is created.\n\n## Multi-root workspaces\n\nWith multi-root workspaces, all operations will work the same way as if you open the first workspace folder in VSCode.\nThe idea is that the first workspace folder is a target folder.\n\nLet's say you have a ```project.code-workspace``` with content:\n\n```json\n{\n  \"folders\": [\n    {\n      \"path\": \"folderA\"\n    },\n    {\n      \"path\": \"folderB\"\n    }\n  ]\n}\n```\n\nAssuming folders are already created, when you open the workspace in VSCode and command to create a micromamba environment, you'll see the following directory structure:\n\n```text\n.\n├── folderA\n│   ├── .micromamba\n│   └── environment.yml\n├── folderB\n```\n\n## How to get it?\n\nSimply open [Micromamba - Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=corker.vscode-micromamba) and click _Install_.\nAlternatively, open Visual Studio Code, go to the extension view and search for _Micromamba_.\n\nFor detailed releases and migration help, please see [releases](https://github.com/mamba-org/vscode-micromamba/releases).\n\n## Maintainers\n\nMichael Borisov ([@corker](https://github.com/corker)).\n\n## Want to Contribute?\n\nThanks for considering! Check [here](CONTRIBUTING.md) for useful tips and guidelines.\n\n### License\n\nWe use a shared copyright model that enables all contributors to maintain the copyright on their contributions.\n\nThis software is licensed under the BSD-3-Clause license. See the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmamba-org%2Fvscode-micromamba","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmamba-org%2Fvscode-micromamba","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmamba-org%2Fvscode-micromamba/lists"}