{"id":28380,"library":"tensorflow-io-nightly","title":"TensorFlow IO Nightly","description":"Nightly build of TensorFlow I/O, a library of datasets and file system extensions for TensorFlow. Provides support for reading/writing various file formats (e.g., Apache Avro, Parquet, TFRecord) and distributed file systems (e.g., S3, GCS, HDFS). Latest stable up to 0.37.1. Release cadence weekly to monthly.","status":"active","version":"0.31.0.dev20230309180344","language":"python","source_language":"en","source_url":"https://github.com/tensorflow/io","tags":["tensorflow","io","nightly","datasets","filesystem"],"install":[{"cmd":"pip install tensorflow-io-nightly","lang":"bash","label":"Install nightly build"}],"dependencies":[{"reason":"Required runtime dependency; tensorflow-io is an extension for TensorFlow.","package":"tensorflow","optional":false},{"reason":"Do NOT install both tensorflow-io and tensorflow-io-nightly simultaneously.","package":"tensorflow-io","optional":true}],"imports":[{"note":"Common mistake: users try to import from an 'io' submodule that does not exist.","wrong":"import tensorflow_io.io as tfio","symbol":"IOTensor","correct":"from tensorflow_io import IOTensor"},{"note":"The correct top-level alias is directly 'tensorflow_io', not 'tensorflow_io.io'.","wrong":"import tensorflow_io.io as tfio","symbol":"tfio","correct":"import tensorflow_io as tfio"}],"quickstart":{"code":"import tensorflow as tf\nimport tensorflow_io as tfio\n\n# Read a CSV file using the experimental CSV dataset\ndataset = tfio.experimental.IODataset.from_tfrecord('/path/to/file.tfrecord')\nfor record in dataset.take(1):\n    print(record)","lang":"python","description":"Basic usage: import and read a TFRecord file using the experimental IODataset."},"warnings":[{"fix":"Uninstall both with 'pip uninstall tensorflow-io tensorflow-io-nightly', then install only the desired one.","message":"tensorflow-io-nightly and tensorflow-io are different packages. Do NOT install both; they conflict. Use one or the other.","severity":"gotcha","affected_versions":"all"},{"fix":"Use the stable 'tensorflow-io' package for production.","message":"tensorflow-io-nightly is a nightly build and may be unstable or have breaking changes. It is not intended for production use.","severity":"breaking","affected_versions":"all"},{"fix":"Upgrade to TensorFlow 2.x and use the recommended IODataset API.","message":"Some APIs in tensorflow_io (e.g., certain dataset constructors) rely on TensorFlow 2.x patterns and may not work with TensorFlow 1.x.","severity":"deprecated","affected_versions":">=0.30.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run 'pip install tensorflow-io-nightly' (or 'tensorflow-io' for stable).","cause":"Package not installed, or installed under different name (tensorflow-io vs tensorflow-io-nightly).","error":"ModuleNotFoundError: No module named 'tensorflow_io'"},{"fix":"Use 'from tensorflow_io.experimental import IOTensor' for experimental versions.","cause":"Incorrect import path; IOTensor may be under tensorflow_io.experimental or may not exist in the installed version.","error":"ImportError: cannot import name 'IOTensor' from 'tensorflow_io'"},{"fix":"Use 'import tensorflow_io as tfio' or 'from tensorflow_io import ...' directly.","cause":"Wrong import pattern; users try to import tensorflow_io.io as a submodule.","error":"AttributeError: module 'tensorflow_io' has no attribute 'io'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}