Skip to main content

Copy data from any source to any destination without any code


ingestr is a command-line app that allows you to ingest data from any source into any destination using simple command-line flags, no code necessary.

  • โœจ copy data from your database into any destination
  • โž• incremental loading: append, merge or delete+insert
  • ๐Ÿ single-command installation

ingestr takes away the complexity of managing any backend or writing any code for ingesting data, simply run the command and watch the data land on its destination.

MongoDB to Postgres benchmark

Installation

You can install ingestr using the install script:

curl -LsSf https://getbruin.com/install/ingestr | sh

Alternatively, you can install it with pip:

pip install ingestr

The pip package can also be used from Python. Install the SDK extra for Python data ingestion:

pip install 'ingestr[sdk]'

Python rows, generators, and DataFrames are sent to the bundled ingestr binary as Arrow IPC streams by default:

import ingestr

ingestr.ingest(
    [{"id": 1, "name": "Ada"}, {"id": 2, "name": "Grace"}],
    dest_uri="duckdb:///tmp/warehouse.duckdb",
    dest_table="main.people",
)

DataFrames and yielded data use the same Arrow stream transport:

ingestr.ingest(df, dest_uri="duckdb:///tmp/warehouse.duckdb", dest_table="main.events")

def events():
    yield [{"id": 1, "event": "signup"}]
    yield [{"id": 2, "event": "purchase"}]

ingestr.ingest(events, dest_uri="postgresql://...", dest_table="public.events")

For push-style code, omit the data argument and use ingest as a context manager. The context value accepts the same shapes as ingestr.ingest(data, ...):

with ingestr.ingest(dest_uri="postgresql://...", dest_table="public.events") as ingest:
    for response in client.list_events():
        ingest(response["items"])

For very large already-materialized data, use the existing mmap Arrow IPC file transport:

ingestr.ingest(df, dest_uri="duckdb:///tmp/warehouse.duckdb", dest_table="main.events", transport="mmap")

For full CLI pass-through, use ingestr.run(["ingest", "--source-uri", "...", "--dest-uri", "...", "--source-table", "..."]), or ingestr.run_cli(...) for keyword arguments that map to CLI flags.

Quickstart

ingestr ingest \
    --source-uri 'postgresql://admin:admin@localhost:8837/web?sslmode=disable' \
    --source-table 'public.some_data' \
    --dest-uri 'bigquery://<your-project-name>?credentials_path=/path/to/service/account.json' \
    --dest-table 'ingestr.some_data'

That's it.

This command:

  • gets the table public.some_data from the Postgres instance.
  • uploads this data to your BigQuery warehouse under the schema ingestr and table some_data.

Documentation

You can see the full documentation here.

Community

Join our Slack community here.

Contributing

Pull requests are welcome. However, please open an issue first to discuss what you would like to change. We maybe able to offer you help and feedback regarding any changes you would like to make.

[!NOTE] After cloning ingestr make sure to run make setup to install githooks.

Supported sources & destinations

Source Destination
Databases
AWS Athena โœ… โœ…
Apache Iceberg - โœ…
AWS Redshift โœ… โœ…
Cassandra โœ… โœ…
ClickHouse โœ… โœ…
Couchbase โœ… -
CrateDB โœ… โœ…
Databricks โœ… โœ…
DuckDB โœ… โœ…
DynamoDB โœ… โœ…
Elasticsearch โœ… โœ…
Google BigQuery โœ… โœ…
GCP Spanner โœ… -
IBM Db2 โœ… -
InfluxDB โœ… -
Kafka โœ… -
Local CSV file โœ… โœ…
MaxCompute โœ… โœ…
Microsoft Fabric โœ… โœ…
Microsoft OneLake - โœ…
Microsoft SQL Server โœ… โœ…
MongoDB โœ… โœ…
MotherDuck โœ… โœ…
MySQL โœ… โœ…
Oracle โœ… -
PlanetScale โœ… โœ…
Postgres โœ… โœ…
RabbitMQ โœ… -
SAP Hana โœ… -
Snowflake โœ… โœ…
Socrata โœ… -
SQLite โœ… โœ…
StarRocks โœ… โœ…
Synapse - โœ…
Trino โœ… โœ…
Platforms
Adjust โœ… -
Airtable โœ… -
Allium โœ… -
Amazon Kinesis โœ… -
Anthropic โœ… -
API-Football โœ… -
AppsFlyer โœ… -
Apple Ads โœ… -
Apple App Store โœ… -
Applovin โœ… -
Applovin Max โœ… -
Asana โœ… -
Attio โœ… -
Azure Data Lake Storage Gen2 โœ… โœ…
BallDontLie FIFA โœ… -
Braze โœ… -
Bruin โœ… -
Chess.com โœ… -
ClickUp โœ… -
Cursor โœ… -
Docebo โœ… -
Dune โœ… -
Facebook Ads โœ… -
Fireflies โœ… -
Fluxx โœ… -
football-data.org โœ… -
Frankfurter โœ… -
Freshdesk โœ… -
FundraiseUp โœ… -
G2 โœ… -
GitHub โœ… -
GitLab โœ… -
Google Ads โœ… -
Google Analytics โœ… -
Google Cloud Storage (GCS) โœ… โœ…
Google Sheets โœ… -
Gorgias โœ… -
Granola โœ… -
Hostaway โœ… -
HubSpot โœ… -
Indeed โœ… -
Intercom โœ… -
Internet Society Pulse โœ… -
Jira โœ… -
JobTread โœ… -
Klaviyo โœ… -
Linear โœ… -
LinkedIn Ads โœ… -
Mailchimp โœ… -
Mixpanel โœ… -
Monday โœ… -
Notion โœ… -
Paddle โœ… -
Personio โœ… -
PhantomBuster โœ… -
Pinterest โœ… -
Pipedrive โœ… -
Plus Vibe AI โœ… -
PostHog โœ… -
Primer โœ… -
QuickBooks โœ… -
Reddit Ads โœ… -
RevenueCat โœ… -
S3 โœ… โœ…
Salesforce โœ… -
SFTP โœ… -
SendGrid โœ… -
Shopify โœ… -
Slack โœ… -
Smartsheet โœ… -
Snapchat Ads โœ… -
Solidgate โœ… -
Square โœ… -
Stripe โœ… -
SurveyMonkey โœ… -
TikTok Ads โœ… -
Trello โœ… -
Trustpilot โœ… -
Twilio โœ… -
Wise โœ… -
Zendesk โœ… -
Zoom โœ… -

Feel free to create an issue if you'd like to see support for another source or destination.

License

ingestr is source-available under the Functional Source License 1.1, with Apache 2.0 as the future license. You can use ingestr freely for internal production use, development, testing, education, research, and professional services. You cannot use ingestr to offer a competing commercial ingestion, ELT, connector, or managed data pipeline product/service.

Each version becomes Apache 2.0 two years after release.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

ingestr-1.0.72-py3-none-win_amd64.whl (77.5 MB view details)

Uploaded Python 3Windows x86-64

ingestr-1.0.72-py3-none-manylinux2014_x86_64.whl (77.2 MB view details)

Uploaded Python 3

ingestr-1.0.72-py3-none-manylinux2014_aarch64.whl (68.9 MB view details)

Uploaded Python 3

ingestr-1.0.72-py3-none-macosx_11_0_arm64.whl (70.3 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

ingestr-1.0.72-py3-none-macosx_10_15_x86_64.whl (76.8 MB view details)

Uploaded Python 3macOS 10.15+ x86-64

File details

Details for the file ingestr-1.0.72-py3-none-win_amd64.whl.

File metadata

  • Download URL: ingestr-1.0.72-py3-none-win_amd64.whl
  • Upload date:
  • Size: 77.5 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for ingestr-1.0.72-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 bdcb8b36887fd7363f0bdac7c1b6eba5b0bdc2f8b57fc2d3f072652a1777da0f
MD5 88627dcf4acb56312352e8812158553d
BLAKE2b-256 4904d9589f68d04f6cae75d6a373b290bda62596631d812c15883b0ad4f7723e

See more details on using hashes here.

File details

Details for the file ingestr-1.0.72-py3-none-manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for ingestr-1.0.72-py3-none-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 471c5f237cfbadfaad692ac2679c7352a5f30125217caf7d3b0232d6085a5b00
MD5 44d8383eef88fd0f56394eaae66baf7b
BLAKE2b-256 1ef8bbf35fefe686d871bdf0fd48e7fc0284c42f8bae6f36e217655e7b30c2d1

See more details on using hashes here.

File details

Details for the file ingestr-1.0.72-py3-none-manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for ingestr-1.0.72-py3-none-manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 eac895ef730db2434be57e725d2b0b3e2825a9c493371777003afea937c71abd
MD5 a715f652379699e79befb81499184513
BLAKE2b-256 a490a37c0c79994c62371895253b6e56f88d0647e5ba1be4207b20174d2981d6

See more details on using hashes here.

File details

Details for the file ingestr-1.0.72-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for ingestr-1.0.72-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 21640d0dc01e202043b848290f75ca2109f9fd2ef08b7981e3f61c3a0cf69be6
MD5 f9618cb70963f791b83289667e02b4a6
BLAKE2b-256 336a55c6d71ce7127edfc99201277a6f5cbfe5e9832ceef59b358604f79f86e2

See more details on using hashes here.

File details

Details for the file ingestr-1.0.72-py3-none-macosx_10_15_x86_64.whl.

File metadata

File hashes

Hashes for ingestr-1.0.72-py3-none-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 63ba12766a00c2c443d38e7d108dbeae151520a6e32c9f7efebbb539f2ea5cb6
MD5 420b7a8982bf6f424e171539b911a1e8
BLAKE2b-256 e60be7646829f4d7b1697109c6f704bbbb48292279aeb7edf663194de23a7030

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page