{"id":15060703,"url":"https://github.com/googleapis/python-bigquery-dataframes","last_synced_at":"2026-03-16T23:03:54.240Z","repository":{"id":191206990,"uuid":"667598363","full_name":"googleapis/python-bigquery-dataframes","owner":"googleapis","description":"BigQuery DataFrames","archived":false,"fork":false,"pushed_at":"2025-05-12T21:38:18.000Z","size":18771,"stargazers_count":244,"open_issues_count":55,"forks_count":48,"subscribers_count":28,"default_branch":"main","last_synced_at":"2025-05-12T21:39:15.521Z","etag":null,"topics":["bigquery","data-science","machine-learning","python"],"latest_commit_sha":null,"homepage":"https://cloud.google.com/python/docs/reference/bigframes/latest","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/googleapis.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":"docs/supported_pandas_apis.rst","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-07-17T22:06:16.000Z","updated_at":"2025-05-12T21:31:05.000Z","dependencies_parsed_at":"2023-08-28T20:16:24.359Z","dependency_job_id":"b840876b-a26b-4e7e-9d46-84884153dd41","html_url":"https://github.com/googleapis/python-bigquery-dataframes","commit_stats":{"total_commits":999,"total_committers":31,"mean_commits":"32.225806451612904","dds":0.8088088088088088,"last_synced_commit":"3072d382c6ff57bdb37d7e080c794c67dbf6e701"},"previous_names":["googleapis/python-bigquery-dataframes"],"tags_count":82,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googleapis%2Fpython-bigquery-dataframes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googleapis%2Fpython-bigquery-dataframes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googleapis%2Fpython-bigquery-dataframes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googleapis%2Fpython-bigquery-dataframes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/googleapis","download_url":"https://codeload.github.com/googleapis/python-bigquery-dataframes/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253829863,"owners_count":21970988,"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":["bigquery","data-science","machine-learning","python"],"created_at":"2024-09-24T23:03:20.801Z","updated_at":"2026-03-16T23:03:54.235Z","avatar_url":"https://github.com/googleapis.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"BigQuery DataFrames (BigFrames)\n===============================\n\n\n|GA| |pypi| |versions|\n\nBigQuery DataFrames (also known as BigFrames) provides a Pythonic DataFrame\nand machine learning (ML) API powered by the BigQuery engine. It provides modules\nfor many use cases, including:\n\n* `bigframes.pandas \u003chttps://dataframes.bigquery.dev/reference/api/bigframes.pandas.html\u003e`_\n  is a pandas API for analytics. Many workloads can be\n  migrated from pandas to bigframes by just changing a few imports.\n* `bigframes.ml \u003chttps://dataframes.bigquery.dev/reference/index.html#ml-apis\u003e`_\n  is a scikit-learn-like API for ML.\n* `bigframes.bigquery.ai \u003chttps://dataframes.bigquery.dev/reference/api/bigframes.bigquery.ai.html\u003e`_\n  are a collection of powerful AI methods, powered by Gemini.\n\nBigQuery DataFrames is an `open-source package \u003chttps://github.com/googleapis/python-bigquery-dataframes\u003e`_.\n\n.. |GA| image:: https://img.shields.io/badge/support-GA-gold.svg\n   :target: https://github.com/googleapis/google-cloud-python/blob/main/README.rst#general-availability\n.. |pypi| image:: https://img.shields.io/pypi/v/bigframes.svg\n   :target: https://pypi.org/project/bigframes/\n.. |versions| image:: https://img.shields.io/pypi/pyversions/bigframes.svg\n   :target: https://pypi.org/project/bigframes/\n\nGetting started with BigQuery DataFrames\n----------------------------------------\n\nThe easiest way to get started is to try the\n`BigFrames quickstart \u003chttps://cloud.google.com/bigquery/docs/dataframes-quickstart\u003e`_\nin a `notebook in BigQuery Studio \u003chttps://cloud.google.com/bigquery/docs/notebooks-introduction\u003e`_.\n\nTo use BigFrames in your local development environment,\n\n1. Run ``pip install --upgrade bigframes`` to install the latest version.\n\n2. Setup `Application default credentials \u003chttps://cloud.google.com/docs/authentication/set-up-adc-local-dev-environment\u003e`_\n   for your local development environment enviroment.\n\n3. Create a `GCP project with the BigQuery API enabled \u003chttps://cloud.google.com/bigquery/docs/sandbox\u003e`_.\n\n4. Use the ``bigframes`` package to query data.\n\n.. code-block:: python\n\n    import bigframes.pandas as bpd\n\n    bpd.options.bigquery.project = your_gcp_project_id  # Optional in BQ Studio.\n    bpd.options.bigquery.ordering_mode = \"partial\"  # Recommended for performance.\n    df = bpd.read_gbq(\"bigquery-public-data.usa_names.usa_1910_2013\")\n    print(\n        df.groupby(\"name\")\n        .agg({\"number\": \"sum\"})\n        .sort_values(\"number\", ascending=False)\n        .head(10)\n        .to_pandas()\n    )\n\nDocumentation\n-------------\n\nTo learn more about BigQuery DataFrames, visit these pages\n\n* `Introduction to BigQuery DataFrames (BigFrames) \u003chttps://cloud.google.com/bigquery/docs/bigquery-dataframes-introduction\u003e`_\n* `Sample notebooks \u003chttps://github.com/googleapis/python-bigquery-dataframes/tree/main/notebooks\u003e`_\n* `API reference \u003chttps://dataframes.bigquery.dev/\u003e`_\n* `Source code (GitHub) \u003chttps://github.com/googleapis/python-bigquery-dataframes\u003e`_\n\nLicense\n-------\n\nBigQuery DataFrames is distributed with the `Apache-2.0 license\n\u003chttps://github.com/googleapis/python-bigquery-dataframes/blob/main/LICENSE\u003e`_.\n\nIt also contains code derived from the following third-party packages:\n\n* `Ibis \u003chttps://ibis-project.org/\u003e`_\n* `pandas \u003chttps://pandas.pydata.org/\u003e`_\n* `Python \u003chttps://www.python.org/\u003e`_\n* `scikit-learn \u003chttps://scikit-learn.org/\u003e`_\n* `XGBoost \u003chttps://xgboost.readthedocs.io/en/stable/\u003e`_\n* `SQLGlot \u003chttps://sqlglot.com/sqlglot.html\u003e`_\n\nFor details, see the `third_party\n\u003chttps://github.com/googleapis/python-bigquery-dataframes/tree/main/third_party/bigframes_vendored\u003e`_\ndirectory.\n\n\nContact Us\n----------\n\nFor further help and provide feedback, you can email us at `bigframes-feedback@google.com \u003chttps://mail.google.com/mail/?view=cm\u0026fs=1\u0026tf=1\u0026to=bigframes-feedback@google.com\u003e`_.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogleapis%2Fpython-bigquery-dataframes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoogleapis%2Fpython-bigquery-dataframes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogleapis%2Fpython-bigquery-dataframes/lists"}