{"id":18554303,"url":"https://github.com/oracle/oci-mlflow","last_synced_at":"2025-10-20T09:35:18.902Z","repository":{"id":171531592,"uuid":"647868804","full_name":"oracle/oci-mlflow","owner":"oracle","description":"The Oracle Cloud Infrastructure (OCI) MLflow plugin empowers users of OCI by providing seamless integration with OCI resources, allowing them to effectively manage the entire life cycle of their machine learning use cases.","archived":false,"fork":false,"pushed_at":"2025-03-18T19:13:50.000Z","size":239,"stargazers_count":22,"open_issues_count":0,"forks_count":4,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-03-18T20:26:36.120Z","etag":null,"topics":["accelerated-data-science","cloud","machine-learning","mlflow","mlflow-tracking-server","mlops","oci","oracle","oracle-ads"],"latest_commit_sha":null,"homepage":"https://oci-mlflow.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"upl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oracle.png","metadata":{"files":{"readme":"README-development.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-31T17:40:18.000Z","updated_at":"2025-03-18T19:13:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"e2c09ea8-2a84-4a7e-879f-9aaee7bfb291","html_url":"https://github.com/oracle/oci-mlflow","commit_stats":null,"previous_names":["oracle/oci-mlflow"],"tags_count":2,"template":false,"template_full_name":"oracle/template-repo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Foci-mlflow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Foci-mlflow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Foci-mlflow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Foci-mlflow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oracle","download_url":"https://codeload.github.com/oracle/oci-mlflow/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248129612,"owners_count":21052606,"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":["accelerated-data-science","cloud","machine-learning","mlflow","mlflow-tracking-server","mlops","oci","oracle","oracle-ads"],"created_at":"2024-11-06T21:21:09.916Z","updated_at":"2025-10-20T09:35:18.841Z","avatar_url":"https://github.com/oracle.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Development\nThe target audience for this README is developers wanting to contribute to `OCI MLflow` plugins. If you want to use the OCI MLflow plugins with your own programs, see `README.md`.\n\n## Setting Up Dependencies\n\n```\npython3 -m pip install -r dev-requirements.txt\n```\n\n# Generating the wheel\nThe OCI MLflow plugins are packaged as a wheel. To generate the wheel, you can run:\n\n```\nmake dist\n```\n\nAlternatively you can run -\n\n```\npython -m build\n```\n\nThis wheel can then be installed using pip.\n\n\n## Setting Up Tracking Server\n\nCreate a file called `.env` in the root folder of the project with following contents -\n\n```\n# Defaults to resource_principal if not provided\nOCIFS_IAM_TYPE=api_key\n\n# Artifacts location. Can be local folder or OCI Object Storage bucket\nMLFLOW_ARTIFACTS_DESTINATION=oci://bucket@namespace/\nMLFLOW_DEFAULT_ARTIFACT_ROOT=oci://bucket@namespace/\n\n# Backend provider. Default is sqllite\nBACKEND_PROVIDER=sqllite\n\n# ------MySQL-----------------------\n# BACKEND_PROVIDER=mysql\n\n# The database credentials can be stored in the Vault service, or they can be provided in the config.\n# See more details how to save the credentials to the Vault -\n# https://accelerated-data-science.readthedocs.io/en/latest/user_guide/secrets/mysql.html\n\n# DB_SECRET_OCID=ocid1.vaultsecret.oc1.iad..\u003cunique_ID\u003e\n\n# ----OR------------------------------\n# MLFLOW_BACKEND_STORE_URI=mysql+mysqlconnector://{username}:{password}@{host}:{db_port}/{db_name}\n# ------------------------------------\n\nMLFLOW_SERVE_ARTIFACTS=1\nMLFLOW_GUNICORN_OPTS=--log-level debug\nMLFLOW_WORKERS=4\nMLFLOW_HOST=0.0.0.0\n```\n\n### Building And Running Tracking Server\n\nTo build an `oci-mlflow` container image run -\n\n```\nmake clean build-image\n```\n\nAlternatively you can run -\n```\ndocker build --network host --build-arg RND=1 -t oci-mlflow:latest -f container-image/Dockerfile .\n```\n\nTo build and launch tracking server run -\n\n```\nmake clean launch\n```\n\nAlternatively you can run -\n```\ndocker build --network host --build-arg RND=1 -t oci-mlflow:latest -f container-image/Dockerfile .\ndocker run --rm -it --net host -v ~/.oci:/root/.oci --env-file .env --name oci-mlflow:latest\n```\n\nTo build `oci-mlflow` wheel file and then rebuild and launch the container image, run -\n\n```\nmake clean wheel launch\n```\n\nAlternatively you can run -\n\n```\npython -m build\ncp dist/*.whl container-image/run/\ndocker build --network host --build-arg RND=1 -t oci-mlflow:latest -f container-image/Dockerfile .\ndocker run --rm -it --net host -v ~/.oci:/root/.oci --env-file .env --name oci-mlflow oci-mlflow:latest\n```\n\nTo build and start a shell prompt within `oci-mlflow` container image, run -\n\n```\nmake clean wheel launch-shell\n```\n\nAlternatively you can run -\n\n```\npython -m build\ncp dist/*.whl container-image/run/\ndocker build --network host --build-arg RND=1 -t oci-mlflow:latest -f container-image/Dockerfile .\ndocker run --rm -it --net host -v ~/.oci:/root/.oci --env-file .env --entrypoint bash --name oci-mlflow-shell oci-mlflow:latest\n```\n\n# Running Tests\nThe SDK uses pytest as its test framework. To run tests use:\n\n```\npython3 -m pytest tests/*\n```\n\n# Generating Documentation\nSphinx is used for documentation. You can generate HTML locally with the following:\n\n```\npython3 -m pip install -r dev-requirements.txt\ncd docs\nmake html\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle%2Foci-mlflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foracle%2Foci-mlflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle%2Foci-mlflow/lists"}