# W&B and Neptune imports Import existing W&B or Neptune experiment history from export files on your machine. Vendor files and credentials stay local: InstantML receives normalized import chunks, shows a dry-run summary, and writes runs only after you commit. > **Info:** This page covers export-file imports. To migrate directly from W&B through the local `wandb` SDK — no export file needed — follow the [W&B import guide](/docs/guides/wandb-import-guide.md) instead. ## Install and authenticate Install the extras for your source and authenticate the CLI once: ```bash pip install "instantml[imports]" instantml login ``` The `[imports]` extra pulls in pyarrow for reading Neptune Exporter Parquet files. W&B and MLflow transformed JSON imports need no extra. ## Import a W&B export file Point the importer at a W&B transformed JSON export and preview it with `--dry-run`: ```bash instantml import wandb \ --project cartpole \ --input ./wandb-export.json \ --dry-run ``` The CLI converts runs, configs, scalar history, tags, notes, and artifact references into import chunks, uploads the staged job, and prints the job id, status, and run, metric, and artifact counts — without committing anything. ## Import a Neptune Exporter directory Export the Neptune project with Neptune Exporter first. Keep the generated Parquet data directory and optional files directory together, then run a dry-run import: ```bash instantml import neptune \ --project cartpole \ --input ./neptune-export/data \ --files-path ./neptune-export/files \ --source-project "workspace/project" \ --dry-run ``` The Neptune importer streams Parquet rows into bounded import chunks instead of loading full metric history into memory. File attributes become artifact references; scalar series become metric points; params, tags, notes, and run metadata map into InstantML run metadata and config. ## Review the dry run Check the counts the CLI prints: - Run count. - Metric point count. - Artifact-reference count. - Job status. For warning messages and progress detail, fetch the job with the id the CLI printed: ```bash curl https://api.instantml.ai/api/imports/jobs/42 \ -H "Authorization: Bearer instantml_..." ``` If the counts or warnings look wrong, cancel the staged job, then rerun the CLI with a corrected export path or a smaller source project: ```bash curl -X POST https://api.instantml.ai/api/imports/jobs/42/cancel \ -H "Authorization: Bearer instantml_..." ``` ## Commit the import Rerun the same import command without `--dry-run` to commit the runs to the target project: ```bash instantml import neptune \ --project cartpole \ --input ./neptune-export/data \ --files-path ./neptune-export/files \ --source-project "workspace/project" ``` > **Note:** Staged chunks count as retained operational storage and each import job has a 2 GiB staged-payload ceiling, so cancel dry-run jobs you decide not to commit. ## Verify in the dashboard After commit, open the target project in the Runs workspace and check: - Expected imported run names. - Configs and tags are searchable. - Scalar metrics appear in charts. - Artifact references are attached to the right runs. - Imported source metadata includes the external run identity. ## Respect compatibility boundaries The importers cover the migration spine: runs, scalar metrics, configs/params, tags, notes, provenance, and artifact references. They do not claim full W&B sweeps/reports/launch parity, full Neptune namespace semantics, or hosted server-side vendor credential pulls. Artifact references are metadata only — upload the actual bytes with the SDK to make them downloadable. ## Next steps - [Imports overview](/docs/guides/imports.md) — every import path, command, and API route. - [W&B import guide](/docs/guides/wandb-import-guide.md) — migrate directly through the local W&B SDK. - [Import, export, and usage API](/docs/api/import-export-usage.md) — job status, commit, and cancel routes. - [Runs workspace](/docs/dashboard/runs-workspace.md) — where imported runs appear. - [Troubleshooting](/docs/troubleshooting.md) — diagnose pyarrow and Parquet import issues. ## Agent navigation - [Docs index](/llms.txt) - [Full docs bundle](/llms-full.txt) ### Get Started - [Overview](/docs/index.md) - [Quickstart](/docs/quickstart.md) - [Core Concepts](/docs/concepts/core-concepts.md) - [Pricing](/docs/pricing.md) - [Benchmarks](/docs/benchmarks.md) - [Examples](/docs/guides/examples.md) - [Troubleshooting](/docs/troubleshooting.md) ### SDK - [Installation Auth](/docs/sdk/installation-auth.md) - [Logging](/docs/sdk/logging.md) - [Tracing](/docs/sdk/tracing.md) - [Metrics Steps](/docs/sdk/metrics-steps.md) - [Config Tags Notes](/docs/sdk/config-tags-notes.md) - [Artifacts Checkpoints](/docs/sdk/artifacts-checkpoints.md) - [Rich Objects](/docs/sdk/rich-objects.md) - [Distributed Training](/docs/sdk/distributed-training.md) - [Console System Integrations](/docs/sdk/console-system-integrations.md) - [Reliability](/docs/sdk/reliability.md) - [Cli Login](/docs/sdk/cli-login.md) - [Querying Data](/docs/sdk/querying-data.md) - [Agent Mcp](/docs/sdk/agent-mcp.md) - [Examples Patterns](/docs/sdk/examples-patterns.md) ### Integrations - [Overview](/docs/integrations/overview.md) - [Pytorch Lightning](/docs/integrations/pytorch-lightning.md) - [Huggingface Transformers](/docs/integrations/huggingface-transformers.md) - [Keras](/docs/integrations/keras.md) - [Wandb](/docs/integrations/wandb.md) ### Dashboard - [Tour](/docs/dashboard/tour.md) - [Organizations Workspaces](/docs/dashboard/organizations-workspaces.md) - [Runs Workspace](/docs/dashboard/runs-workspace.md) - [Metrics Charts](/docs/dashboard/metrics-charts.md) - [Run Detail](/docs/dashboard/run-detail.md) - [Traces](/docs/dashboard/traces.md) - [Compare Runs](/docs/dashboard/compare-runs.md) - [Research Dashboards](/docs/dashboard/research-dashboards.md) - [Artifacts Files](/docs/dashboard/artifacts-files.md) - [Run Health](/docs/dashboard/alerts.md) - [Datasets](/docs/dashboard/datasets.md) - [Checkpoints](/docs/dashboard/checkpoints.md) - [Reports](/docs/dashboard/reports.md) - [Settings Api Keys](/docs/dashboard/settings-api-keys.md) - [Api Tab](/docs/dashboard/api-tab.md) - [Onboarding Team Billing](/docs/dashboard/onboarding-team-billing.md) ### Data - [Imports](/docs/guides/imports.md) - [W&B alternative](/docs/guides/wandb-alternative.md) - [InstantML vs MLflow](/docs/guides/instantml-vs-mlflow.md) - [W&B import guide](/docs/guides/wandb-import-guide.md) - [W&B and Neptune imports](/docs/guides/wandb-neptune-imports.md) (current page) - [Export Usage Limits](/docs/guides/export-usage-limits.md) - [Pricing Limits Billing](/docs/guides/pricing-limits-billing.md) - [Auth Billing Storage](/docs/guides/auth-billing-storage.md) - [Customer Owned Clickhouse](/docs/guides/customer-owned-clickhouse.md) - [Observability](/docs/guides/observability.md) ### API **Practical API guides** - [Authentication](/docs/api/authentication.md) - [Errors And Limits](/docs/api/errors-and-limits.md) - [Health Observability](/docs/api/health-observability.md) - [Projects Runs](/docs/api/projects-runs.md) - [Metrics Series](/docs/api/metrics-series.md) - [Attributes Objects](/docs/api/attributes-objects.md) - [Artifacts](/docs/api/artifacts.md) - [Reports](/docs/api/reports.md) - [Iframe Embeds](/docs/api/iframe-embeds.md) - [Import Export Usage](/docs/api/import-export-usage.md) - [Dashboard Control State](/docs/api/dashboard-control-state.md) **Architecture** - [System Overview](/docs/architecture/system-overview.md) - [Service Planes](/docs/architecture/service-planes.md) - [Storage Model](/docs/architecture/storage-model.md) - [Google Clickhouse](/docs/architecture/google-clickhouse.md) - [Auth Tenancy](/docs/architecture/auth-tenancy.md) - [Schema Reference](/docs/architecture/schema-reference.md) ### API Reference - [API Reference](/docs/api-reference.md)