{"id":45157423,"url":"https://github.com/couchbase-examples/couchbase-jupyter-labs","last_synced_at":"2026-02-20T05:02:43.991Z","repository":{"id":40596218,"uuid":"429830533","full_name":"couchbase-examples/couchbase-jupyter-labs","owner":"couchbase-examples","description":"A series of labs created to start using Couchbase with the Python SDK","archived":false,"fork":false,"pushed_at":"2023-11-23T11:17:59.000Z","size":8706,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2023-11-23T12:27:52.697Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/couchbase-examples.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}},"created_at":"2021-11-19T14:40:50.000Z","updated_at":"2023-04-03T07:51:01.000Z","dependencies_parsed_at":"2023-01-22T22:00:33.882Z","dependency_job_id":null,"html_url":"https://github.com/couchbase-examples/couchbase-jupyter-labs","commit_stats":null,"previous_names":[],"tags_count":0,"template":null,"template_full_name":null,"purl":"pkg:github/couchbase-examples/couchbase-jupyter-labs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/couchbase-examples%2Fcouchbase-jupyter-labs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/couchbase-examples%2Fcouchbase-jupyter-labs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/couchbase-examples%2Fcouchbase-jupyter-labs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/couchbase-examples%2Fcouchbase-jupyter-labs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/couchbase-examples","download_url":"https://codeload.github.com/couchbase-examples/couchbase-jupyter-labs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/couchbase-examples%2Fcouchbase-jupyter-labs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29641929,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-20T03:21:14.183Z","status":"ssl_error","status_checked_at":"2026-02-20T03:18:24.455Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":[],"created_at":"2026-02-20T05:02:38.530Z","updated_at":"2026-02-20T05:02:43.983Z","avatar_url":"https://github.com/couchbase-examples.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Couchbase Jupyter Labs\n\nA series of labs created to start using Couchbase with the Python SDK. It includes the following labs:\n\n- Introduction to Couchbase\n- Key Value Operations\n- Indexing\n- N1QL Querying\n- Full Text Search\n\n## Running the Labs Using Docker Compose\n\n### Prerequisites\n\n- [Docker \u0026 Docker Compose](https://docs.docker.com/compose/install/)\n\nTo bring up the Couchbase and the Jupyter Lab environment with the Couchbase Python SDK, run\n\n`docker-compose up`\n\nAccess the Jupyter Lab environment by clicking on the access URL in the logs as shown in the screenshot below.\n\n![access-jupyter-lab](notebooks/img/access_jupyter_lab.png)\n\nCouchbase can be accessed on\nhttp://localhost:8091/\n\nNote that it might take a few minutes to start Couchbase.\n\nFollow the instructions in [Lab 1](notebooks/Lab_01_Introduction_to_Couchbase.ipynb)\n\nFollow the rest of the labs sequentially.\n\n#### Configuring the Couchbase Cluster Information for Examples\n\n- The configuration is stored in an environment file, .env in this folder.\n\n- Note that you might have to check for hidden files to see this file on Unix environments.\n\n- This file can be used to update the connection settings.\n\n  - DB_HOST: Set to `couchbase://couchbase` by default for connecting to the Couchbase cluster in the docker environment via Docker Compose. If you are running Couchbase locally on your machine via docker or installation, you can change the connection string to `couchbase://localhost`.\n  - DB_USER: Set to `Administrator` by default. If it is different for your cluster, please update the file.\n  - DB_PASSWORD: Set to `Password` by default. If it is different for your cluster, please update the file.\n\n## Running the Labs Locally\n\n### Prerequisites\n\n- Python 3.8 or higher\n\n- Install the Couchbase SDK (v4 or above) \u0026 Jupyter Lab\n\n  `pip install couchbase jupyterlab python-dotenv`\n\n- Running Couchbase using Docker\n\n  `docker run -d --name db -p 8091-8094:8091-8094 -p 11210:11210 couchbase`\n\n- Running the Labs by running Jupyter Lab from this folder\n  `jupyter lab`\n\n## Building Docker Image with Jupyter Lab \u0026 Couchbase SDK\n\n`docker build -t couchbase-jupyter-lab .`\n\nRunning the Image\n`docker run -p 8888:8888 -v $(pwd):/home/jovyan/work -it couchbase-jupyter-lab`\n\nClick on the link to access Jupyter lab from the container logs as shown in the screenshot above.\n\n#### Note\n\nThe Labs are not configured to be run using [Couchbase Capella](https://cloud.couchbase.com/). If you want to run it using Capella, the interface would be slightly different from the screenshots. Also, the connection strings \u0026 options would be slightly different. The connection string would be `couchbases://\u003cconnection_string_from_capella_ui\u003e`. You would also need to whitelist the IP from which you are running the Notebooks on the Capella UI. For more details, you can check the [SDK Documentation](https://docs.couchbase.com/python-sdk/current/hello-world/start-using-sdk.html#full-example) on connecting to Capella.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcouchbase-examples%2Fcouchbase-jupyter-labs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcouchbase-examples%2Fcouchbase-jupyter-labs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcouchbase-examples%2Fcouchbase-jupyter-labs/lists"}