{"id":40311911,"url":"https://github.com/douglaslassance/airstorm","last_synced_at":"2026-01-20T06:35:36.946Z","repository":{"id":54381060,"uuid":"300490937","full_name":"douglaslassance/airstorm","owner":"douglaslassance","description":"A ORM-like Python client for Airtable.","archived":false,"fork":false,"pushed_at":"2022-03-20T22:05:52.000Z","size":54,"stargazers_count":9,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-12-22T01:59:36.888Z","etag":null,"topics":["airtable","orm","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":false,"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/douglaslassance.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":["douglaslassance"]}},"created_at":"2020-10-02T03:31:24.000Z","updated_at":"2024-01-28T03:13:24.000Z","dependencies_parsed_at":"2022-08-13T14:00:41.434Z","dependency_job_id":null,"html_url":"https://github.com/douglaslassance/airstorm","commit_stats":null,"previous_names":["playsthetic/airstorm"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/douglaslassance/airstorm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douglaslassance%2Fairstorm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douglaslassance%2Fairstorm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douglaslassance%2Fairstorm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douglaslassance%2Fairstorm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/douglaslassance","download_url":"https://codeload.github.com/douglaslassance/airstorm/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douglaslassance%2Fairstorm/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28597659,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T02:08:49.799Z","status":"ssl_error","status_checked_at":"2026-01-20T02:08:44.148Z","response_time":117,"last_error":"SSL_read: 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":["airtable","orm","python"],"created_at":"2026-01-20T06:35:36.270Z","updated_at":"2026-01-20T06:35:36.942Z","avatar_url":"https://github.com/douglaslassance.png","language":"Python","funding_links":["https://github.com/sponsors/douglaslassance"],"categories":[],"sub_categories":[],"readme":"# airstorm\n\n[![PyPI version](https://badge.fury.io/py/airstorm.svg)](https://badge.fury.io/py/airstorm)\n[![Documentation Status](https://readthedocs.org/projects/airstorm/badge/?version=latest)](https://airstorm.readthedocs.io/en/latest)\n[![codecov](https://codecov.io/gh/douglaslassance/airstorm/branch/main/graph/badge.svg?token=5267NA3EQQ)](https://codecov.io/gh/douglaslassance/airstorm)\n\nAirstorm is a dynamic Python ORM for [Airtable](https://airtable.com). It allows you to easily interact with any base using Python with minimal setup.\n\n## Main Features\n\n-   Object-oriented interface.\n-   Dynamic generation of data models from schema.\n-   Automatic foreign-key resolution.\n-   Caching layer to avoid abusing the Airtable API.\n\n## Installation\n\n```bash\npip install airstorm\n```\n\n## Usage\n\n```python\nfrom airstorm.base import Base\njamba_juice = Base('your_base_id', 'your_api_key', {'your': 'schema'})\nsmoothy = jamba_juice.Smoothie('some_smoothie_id')  # Get your table record.\nfor fruit in smoothy.fruits:  # Get linked record in a breeze.\n    print(fruit.name)  # Access any field data.\nprint(smoothy.fruits.names) # Access to mutliple record field data at once.\n```\n\n## Getting the Schema\n\nUnfortunatly currently this part of the process is not ideal.\nBecause Airtable does not provide access to the schema via their API, you'll have to \"download\" the schema manually via a web browser of choice.\n\nThe following [gist](https://gist.github.com/douglaslassance/0ba26f2cf2aa9bb21a521ba07d751244) is a script that you can run on a Chrome console from the Airtable base [API page](https://airtable.com/api) to get back the JSON schema that airtstorm is expecting to be fed with.\n\n## Roadmap\n\n-   Field validation where possible.\n-   Push changes. Currently we are read-only.\n-   Downlading schema automatically using pyppeteer.\n-   Pythonic formulas.\n\n## Development\n\nThis projects requires the following:\n\n-   [Python \u003e=3.7.9](https://www.python.org/downloads/release/python-379/)\n-   [virtualenwrapper](https://pypi.org/project/virtualenvwrapper/) (macOS/Linux)\n-   [virtualenwrapper-win](https://pypi.org/project/virtualenvwrapper-win/) (Windows)\n\nMake sure your `WORKON_HOME` environment variable is set on Windows, and create a `airstorm` virtual environment with `mkvirtualenv`.\nBuild systems for installing requirements and running tests are on board of the SublimeText project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdouglaslassance%2Fairstorm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdouglaslassance%2Fairstorm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdouglaslassance%2Fairstorm/lists"}