Package and API index

Fireweave (fireweave.ai) is an AI release engineer that takes every coding-agent change to production safely with control points, cohort rollouts, guardrails, and live stability and adoption signals. Developer index. Full call surfaces live on the SDK pages. All six registries below published 2.3.0 on 2026-09-09. Brand tokens stay as published: npm @fireweaveai/*, PyPI fireweave, Go github.com/FireWeave-HQ/fireweave-sdk/sdks/go/v2, Java ai.fireweave, crates.io fireweave.

Packages

Surface	Package	Published	Runtime
Node / Bun / Deno	`@fireweaveai/server-sdk`	npm 2.3.0 (`latest`)	Node `>=20.20`; Bun `>=1.2`; Deno `>=2.0`
Python	`fireweave`	PyPI 2.3.0	Python `>=3.10`
Go	`github.com/FireWeave-HQ/fireweave-sdk/sdks/go/v2`	module proxy v2.3.0	`go 1.25.13`
Java	`ai.fireweave:fireweave-sdk`	Maven Central 2.3.0	Java 11+
Browser	`@fireweaveai/web-sdk`	npm 2.3.0	Browser. Not a Node/Deno target
Rust	`fireweave`	crates.io 2.3.0	rust-version 1.75; deps `ureq`, `serde`, `serde_json`

@fireweaveai/sdk is frozen at 2.1.0. Do not present it as the Node install target. Use @fireweaveai/server-sdk.

Java artifact skew

fireweave-sdk is 2.3.0. These leftover artifacts remain at 0.1.0 and are not the 2.3.0 SDK:

ai.fireweave:fireweave-openfeature 0.1.0
ai.fireweave:fireweave-adapter-posthog 0.1.0
ai.fireweave:fireweave-testing 0.1.0

Do not imply a uniform 2.3.0 line across every ai.fireweave:* coordinate.

Swift

A Swift package exists in-tree at sdks/swift/Package.swift (iOS 16+, macOS 13+, zero dependencies, tag swift/v2.2.0). Package.swift is not at the repository root, so SwiftPM cannot resolve it from the repository URL. It is not installable. There is no Swift SDK page. Node, Python core, Web, Go, and Java fireweave-sdk have zero runtime dependencies. Rust has exactly three: ureq, serde, serde_json. See Compatibility for the adapter and type matrix.

Env vars and config

No SDK reads environment variables. Credentials are explicit init options in every language.

Name	Who reads it
`FW_API_URL`	Nobody in the SDK. Your app may read it and pass `apiUrl` / `api_url` / `APIURL`.
`FW_PROJECT_API_KEY`	Nobody in the SDK. Your app may read it and pass `apiKey` / `api_key` / `APIKey`.
`FW_DEPRECATION_WARNINGS`	Nothing. Removed. The `flags` alias is silent at runtime (Python emits one `DeprecationWarning` on first access).

Timeouts: request 3000 ms, shutdown 10000 ms. Host allowlists and https rules: Configuration.

Adapters (quick map)

Adapter	Node	Python	Go	Java	Web	Rust
Remote	`FireweaveRemoteAdapter`	`FireweaveRemoteAdapter`	`infrastructure/adapters/remote`	`FireweaveRemoteAdapter`	`FireweaveRemoteWebAdapter`	`FireweaveRemoteAdapter`
Local / dev	`FireweaveLocalAdapter`	`FireweaveLocalAdapter`	`infrastructure/adapters/local`	`FireweaveLocalAdapter`	`FireweaveLocalWebAdapter`	`FireweaveLocalAdapter`
In-memory	`InMemoryAdapter`	`InMemoryAdapter`	`infrastructure/adapters/inmemory`	`InMemoryAdapter` (testing leftover)	`InMemoryWebAdapter`	`InMemoryAdapter`
PostHog / OpenFeature	absent	absent	absent	leftover 0.1.0 artifacts only	absent	absent

initFireweave / init_fireweave / Fireweave.init / fireweave.Init selects remote or local from the required mode option.

Errors

15 kinds. Evaluation never throws. Full table: Errors. Node/Web: FireweaveError. Python: per-kind classes + ErrorKind. Go: fireweave.Error. Java: ErrorKind + FireweaveException. Rust: FireweaveError.

Language gates

API	Node	Python	Go	Java	Web	Rust
Entry point	`initFireweave`	`init_fireweave`	`fireweave.Init`	`Fireweave.init`	`initFireweave`	`init_fireweave`
Product namespace	`controlPoints`	`control_points`	`ControlPoints()`	`controlPoints()`	`controlPoints` (sync)	`control_points`
Deprecated alias	`flags` (silent)	`flags` (one warning)	`Flags()` (silent)	`flags()` (silent)	`flags` (silent)	`flags()` (silent)
Register target	`client.registerTarget`	`client.register_target`	`client.RegisterTarget`	`client.registerTarget`	`registerTarget` + `identify`	`client.register_target`
Typed getters	boolean / string / number / object	boolean / string / number / object	same, `Get*Value`	same, including `getNumberValue` / `getObjectValue`	same (sync)	same, `get_*_value`
Env auto-read	no	no	no	no	no	no

The flags alias shares identity with controlPoints and is not the documented name.

Wire paths

Method	Path	Who implements the client
`POST`	`/v1/flags/evaluate`	All seven remote adapters
`POST`	`/v1/targets/register`	All seven remote adapters
`POST`	`/v1/capture`	Still a protocol path. v1 public surface does not expose exposures or signals. Node and Web remote adapters still define the constant.

Auth: Authorization: Bearer <key>. See HTTP API. The test server implements evaluate and /health — not /v1/targets/register.

Runtime compatibility notes

Node is ESM, portable across Node / Bun / Deno. Deno import: npm:@fireweaveai/server-sdk.
Web targets browsers only. Suite runs on Bun + happy-dom. No server entry point.
Go import and go get must include /v2.
CI “latest” / “stable” / “canary” cells float. Document minimums from manifests.
Swift is in-tree and not distributable. There is no Android, .NET, PHP, or Ruby package under sdks/.

Get Started

SDKs

Concepts

Production

CLI

Terraform

Testing

Troubleshooting

Migration

Reference

Package and API index

Packages

Java artifact skew

Swift

Env vars and config

Adapters (quick map)

Errors

Language gates

Wire paths

Runtime compatibility notes

Next

Node

Python

Go

Java

Web

Rust

Compatibility

​Packages

​Java artifact skew

​Swift

​Env vars and config

​Adapters (quick map)

​Errors

​Language gates

​Wire paths

​Runtime compatibility notes

​Next

Node

Python

Go

Java

Web

Rust

Compatibility

Packages

Java artifact skew

Swift

Env vars and config

Adapters (quick map)

Errors

Language gates

Wire paths

Runtime compatibility notes

Next