{"id":28466863,"url":"https://github.com/mlrun/mlrun-setup","last_synced_at":"2026-02-15T14:34:33.325Z","repository":{"id":65777577,"uuid":"599024313","full_name":"mlrun/mlrun-setup","owner":"mlrun","description":"Utility for installing MLRun","archived":false,"fork":false,"pushed_at":"2024-08-20T06:19:58.000Z","size":90,"stargazers_count":1,"open_issues_count":3,"forks_count":2,"subscribers_count":2,"default_branch":"development","last_synced_at":"2025-06-30T23:35:58.810Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mlrun.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2023-02-08T09:44:31.000Z","updated_at":"2025-04-05T06:16:42.000Z","dependencies_parsed_at":"2023-11-19T11:36:57.442Z","dependency_job_id":null,"html_url":"https://github.com/mlrun/mlrun-setup","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/mlrun/mlrun-setup","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlrun%2Fmlrun-setup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlrun%2Fmlrun-setup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlrun%2Fmlrun-setup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlrun%2Fmlrun-setup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mlrun","download_url":"https://codeload.github.com/mlrun/mlrun-setup/tar.gz/refs/heads/development","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlrun%2Fmlrun-setup/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268528319,"owners_count":24264824,"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","status":"online","status_checked_at":"2025-08-03T02:00:12.545Z","response_time":2577,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2025-06-07T07:06:11.847Z","updated_at":"2026-02-15T14:34:28.268Z","avatar_url":"https://github.com/mlrun.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MLRun Setup\n\nUtility for installing MLRun and auxiliary services locally or over Kubernetes\n\nThis utility can be executed from Python or use one of the packaged binaries (one per OS) in the releases tab\n\n### Using the Python version \n\nThe Python code require two packages (`click` and `dotenv`), make sure they are installed before executing the script.\n\nInstalling the python script:\n\n```\ncurl https://raw.githubusercontent.com/mlrun/mlrun-setup/development/mlsetup.py \u003e mlsetup.py\nchmod u+x mlsetup.py\npip install click~=8.0.0 python-dotenv~=0.17.0\n```\n\nOnce its installed run `./mlsetup.py [COMMAND]` (for example `./mlsetup.py kubernetes`)\n\n### Using the binary version\n\nto download the binary to your system (on Linux or MacOS):\n\n    curl -sfL https://get.mymlrun.org | bash -\n    mlsetup [OPTIONS] COMMAND [ARGS]\n\n## Usage\n\nChoose the specific installation option (local, docker, kubernetes, and remote), \nand run the command with default or custom options (see `mlsetup COMMAND --help` for option specific help).\n\n\u003e When using the python library replace `mlsetup` command with `.\\mlsetup.py`.\n\n```\nUsage: mlsetup [OPTIONS] COMMAND [ARGS]...\n\n  MLRun configuration utility\n\nOptions:\n  --help  Show this message and exit.\n\nCommands:\n  clear       Delete the default or specified config .env file\n  docker      Deploy mlrun and nuclio services using Docker compose\n  get         Print the local or remote configuration\n  kubernetes  Install MLRun service on Kubernetes\n  latest      Get the latest MLRun version\n  local       Install MLRun service as a local process (limited, no UI...\n  pause       Scale MLRun deployments to zero Plese note - if you want to...\n  remote      Connect to remote MLRun service (over Kubernetes)\n  scale       Scale up MLRun deployments\n  set         Set configuration in mlrun default or specified .env file\n  start       Start MLRun service, auto detect the best method...\n  stop        Stop MLRun service which was started using this CLI\n  uninstall   Uninstall and cleanup MLRun service which was started using...\n```\n\n### Install with Docker Compose\n\n```\nUsage: mlsetup docker [OPTIONS]\n\n  Deploy mlrun and nuclio services using Docker compose\n\nOptions:\nOptions:\n  -j, --jupyter TEXT        deploy Jupyter container, can provide jupyter\n                            image as argument\n  -d, --data-volume TEXT    host path prefix to the location of db and\n                            artifacts\n  --volume-mount TEXT       container mount path (of the data-volume), when\n                            different from host data volume path\n  -a, --artifact-path TEXT  default artifact path (if not in the data volume)\n  --foreground              run process in the foreground (not as a daemon)\n  -p, --port INTEGER        MLRun port to listen on\n  -e, --env-vars TEXT       additional env vars, e.g. -e\n                            AWS_ACCESS_KEY_ID=\u003ckey-id\u003e\n  -f, --env-file TEXT       path to the mlrun .env file (defaults to\n                            '~/.mlrun.env')\n  --tag TEXT                MLRun version tag\n  -o, --options TEXT        optional services to enable, supported services:\n                            jupyter,milvus,mysql\n  --compose-file TEXT       path to save the generated compose.yaml file\n  -v, --verbose             verbose log\n  --simulate                simulate install (print commands vs exec)\n  --help                    Show this message and exit.\n```\n\n### Install with Kubernetes\n\n```\nUsage: mlsetup.py kubernetes [OPTIONS]\n\n  Install MLRun service on Kubernetes\n\nOptions:\n  -n, --name TEXT           helm deployment name\n  --namespace TEXT          kubernetes namespace\n  -r, --registry-args TEXT  docker registry args, can be a kind string (local,\n                            docker, ..) or a set of key=value args e.g. -r\n                            username=joe -r password=j123 -r\n                            email=joe@email.com, supported keys: kind,server,u\n                            sername,password,email,url,secret,push_secret\n  -o, --options TEXT        optional services to enable, supported services:\n                            spark,monitoring,jupyter,pipelines\n  -d, --disable TEXT        optional services to disable, supported services:\n                            spark,monitoring,jupyter,pipelines\n  -s, --set TEXT            Additional helm --set commands, accept multiple\n                            --set options\n  --external-addr TEXT      external ip/dns address\n  --tag TEXT                MLRun version tag\n  -f, --env-file TEXT       path to the mlrun .env file (defaults to\n                            '~/.mlrun.env')\n  -e, --env-vars TEXT       additional env vars, e.g. -e\n                            AWS_ACCESS_KEY_ID=\u003ckey-id\u003e\n  -v, --verbose             verbose log\n  --simulate                simulate install (print commands vs exec)\n  --chart-ver TEXT          MLRun helm chart version\n  -j, --jupyter TEXT        deploy Jupyter container, can provide jupyter\n                            image as argument\n  --help                    Show this message and exit.\n```\n\n### Uninstall\n\n```\nUUsage: mlsetup.py uninstall [OPTIONS]\n\n  Uninstall and cleanup MLRun service which was started using this CLI\n\nOptions:\n  -f, --env-file TEXT    path to the mlrun .env file (defaults to\n                         '~/.mlrun.env')\n  -d, --deployment TEXT  deployment mode: local | docker | kuberenetes\n  -f, --force            force stop\n  -v, --verbose          verbose log\n  --help                 Show this message and exit.\n```\n\n## Build\n\n \nto build the binary run: \n \n    pyinstaller -F mlsetup.py\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlrun%2Fmlrun-setup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmlrun%2Fmlrun-setup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlrun%2Fmlrun-setup/lists"}