{"id":45262,"library":"lamindb-setup","title":"LaminDB Setup","description":"Setup & configure LaminDB, a data management framework for biological data. Version 1.25.0, monthly releases. Handles authentication, instance configuration, and environment setup for LaminDB.","status":"active","version":"1.25.0","language":"python","source_language":"en","source_url":"https://github.com/laminlabs/lamindb-setup","tags":["lamindb","data-management","biology","setup"],"install":[{"cmd":"pip install lamindb-setup","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Core LaminDB API for data operations","package":"lamindb","optional":true}],"imports":[{"wrong":"import lamindb.setup as ln_setup","symbol":"connect","correct":"from lamindb_setup import connect"},{"wrong":"import lamindb.setup as ln_setup","symbol":"login","correct":"from lamindb_setup import login"},{"wrong":"import lamindb.setup as ln_setup","symbol":"init","correct":"from lamindb_setup import init"}],"quickstart":{"code":"import lamindb.setup as ln_setup\nimport os\n\nln_setup.init(storage=\"./test_storage\", modules=\"bionty\")","lang":"python","description":"Initialize a local LaminDB instance with storage directory and required modules (e.g., bionty)."},"warnings":[{"fix":"Always pass a list of module names (e.g., `modules='bionty'`).","message":"In version 1.0+, `lamindb.setup.init()` requires the `modules` parameter; omitting it raises an error.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Use `ln_setup.settings.instance.db` or set environment variables `LAMINDB_DB` and `LAMINDB_PASSWORD`.","message":"The `init` function no longer accepts `db` or `password` parameters. Database configuration is now done via LaminDB settings or environment variables.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Replace `ln_setup.login()` with `ln_setup.init(...)`.","message":"`lamindb.setup.login()` is deprecated; use `ln_setup.init(storage=..., modules=...)` instead.","severity":"deprecated","affected_versions":">=1.10.0"},{"fix":"Set `LAMINDB_INSTANCE` in your shell or use `os.environ['LAMINDB_INSTANCE']='...'` before import.","message":"The environment variable `LAMINDB_INSTANCE` must be set before importing `lamindb.setup` if you want to use a remote instance. Otherwise, a local instance is created.","severity":"gotcha","affected_versions":"all"},{"fix":"Check `ln_setup.is_initialized()` before calling `init()`, or restart the Python session.","message":"Calling `ln_setup.init()` more than once in the same session raises a `RuntimeError`.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'1.25.0':14 'authent':18 'biolog':11,30 'configur':4,20 'data':7,12,28 'data-manag':27 'environ':22 'framework':9 'handl':17 'instanc':19 'lamindb':1,5,25,26 'manag':8,29 'month':15 'releas':16 'setup':2,3,23,31 'version':13","created_at":"2026-06-07T12:54:08.682929+00:00","updated_at":"2026-06-07T12:54:08.682929+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["database","ai-ml"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-08-02","install_tag":null}}