Fireweave is the AI release engineer for teams shipping with coding agents. Every change rolls out behind a control point, one step at a time, with guardrails watching real users — and if something breaks, Fireweave pauses or rolls it back before most users ever see it. It's the only way to ship as fast as your agents write code, without the fear of breaking production.
Node.js · Bun · Deno
npm install @fireweaveai/server-sdk
# bun add @fireweaveai/server-sdk · deno add npm:@fireweaveai/server-sdkCommonJS project that cannot load ES modules (Jest's default config, TypeScript node10/node16 output)? See Module formats.
import { initFireweave } from '@fireweaveai/server-sdk';
const fireweave = await initFireweave({
mode: 'remote',
apiUrl: process.env.FW_API_URL!,
apiKey: process.env.FW_PROJECT_API_KEY!,
});
// Once per user: the facts your targeting rules match on.
await fireweave.registerTarget('user_42', { kind: 'user', properties: { plan: 'pro' } });
// Per request: evaluate a control point.
const enabled = await fireweave.controlPoints.getBooleanValue('new-checkout', false, {
targetingKey: 'user_42',
});
console.log('new-checkout:', enabled);
await fireweave.shutdown();Web (browser)
npm install @fireweaveai/web-sdkimport { initFireweave } from '@fireweaveai/web-sdk';
const fireweave = await initFireweave({
mode: 'remote',
apiUrl: 'https://app-server.fireweave.ai',
apiKey: 'YOUR_PROJECT_API_KEY',
});
// Register the user, then fetch their decisions.
await fireweave.identify('user_42', { kind: 'user', properties: { plan: 'pro' } });
// Reads are synchronous: safe inside a render path.
const enabled = fireweave.controlPoints.getBooleanValue('new-checkout', false);
console.log('new-checkout:', enabled);
await fireweave.shutdown();Python
pip install fireweaveimport os
from fireweave import EvaluationContext, RegisterTargetOptions, init_fireweave
client = init_fireweave(
mode="remote",
api_url=os.environ["FW_API_URL"],
api_key=os.environ["FW_PROJECT_API_KEY"],
)
# Once per sign-in: the durable facts your targeting rules match on.
client.register_target(
"user_42", RegisterTargetOptions(kind="user", properties={"plan": "pro"})
)
# Per request.
enabled = client.control_points.get_boolean_value(
"new-checkout", False, EvaluationContext("user_42")
)
print("new-checkout:", enabled)
client.shutdown()Go
go get github.com/FireWeave-HQ/fireweave-sdk/sdks/go/v3package main
import (
"context"
"fmt"
"log"
"os"
"github.com/FireWeave-HQ/fireweave-sdk/sdks/go/v3/fireweave"
)
func main() {
client, err := fireweave.Init(fireweave.Options{
Mode: fireweave.ModeRemote,
APIURL: os.Getenv("FW_API_URL"),
APIKey: os.Getenv("FW_PROJECT_API_KEY"),
})
if err != nil {
log.Fatal(err)
}
defer client.Runtime().Shutdown(context.Background())
// Once per login: the durable facts your targeting rules match on.
client.RegisterTarget("user_42", &fireweave.RegisterTargetOptions{
Kind: fireweave.TargetKindUser,
Properties: map[string]any{"plan": "pro"},
})
// Per request: evaluate a control point.
user := fireweave.NewEvaluationContext("user_42", nil)
enabled := client.ControlPoints().GetBooleanValue("new-checkout", false, &user)
fmt.Println("new-checkout:", enabled)
}Java
<dependency>
<groupId>ai.fireweave</groupId>
<artifactId>fireweave-sdk</artifactId>
<version>3.0.0</version>
</dependency>import ai.fireweave.sdk.application.Fireweave;
import ai.fireweave.sdk.application.FireweaveClient;
import ai.fireweave.sdk.application.InitOptions;
import ai.fireweave.sdk.application.RegisterTargetOptions;
import ai.fireweave.sdk.domain.EvaluationContext;
import ai.fireweave.sdk.domain.JsonValue;
import ai.fireweave.sdk.domain.TargetKind;
public class Quickstart {
public static void main(String[] args) {
// remote(apiKey, apiUrl): the SDK never reads env vars itself
InitOptions options = InitOptions.remote(
System.getenv("FW_PROJECT_API_KEY"), System.getenv("FW_API_URL"));
try (FireweaveClient client = Fireweave.init(options)) {
client.registerTarget("user_42", RegisterTargetOptions.builder()
.kind(TargetKind.USER)
.property("plan", JsonValue.of("pro"))
.build());
boolean enabled = client.controlPoints().getBooleanValue("new-checkout", false,
EvaluationContext.builder().targetingKey("user_42").build());
System.out.println("new-checkout = " + enabled);
}
}
}Rust
cargo add fireweaveuse fireweave::{
init_fireweave, EvaluationContext, InitOptions, RegisterTargetOptions, TargetKind,
};
fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = init_fireweave(InitOptions::remote(
std::env::var("FW_PROJECT_API_KEY")?,
std::env::var("FW_API_URL")?,
))?;
// Once per login: the facts your targeting rules match on.
let target = RegisterTargetOptions {
kind: Some(TargetKind::User),
properties: Some([("plan".into(), "pro".into())].into_iter().collect()),
..Default::default()
};
client.register_target("user_42", Some(&target));
let ctx = EvaluationContext::new().with_targeting_key("user_42");
let enabled = client
.control_points
.get_boolean_value("new-checkout", false, Some(&ctx));
println!("new-checkout: {enabled}");
client.shutdown();
Ok(())
}Swift · iOS · macOS
# Not on a registry yet: clone next to your package
git clone https://github.com/FireWeave-HQ/fireweave-sdk// Package.swift (swift-tools-version: 6.0)
platforms: [.macOS(.v13), .iOS(.v16)],
dependencies: [.package(path: "../fireweave-sdk/sdks/swift")],
// in your target
dependencies: [.product(name: "Fireweave", package: "swift")]import Fireweave
import Foundation
let env = ProcessInfo.processInfo.environment
let fireweave = try await initFireweave(.remote(InitFireweaveRemoteOptions(
apiKey: env["FW_PROJECT_API_KEY"] ?? "",
apiUrl: env["FW_API_URL"] ?? ""
)))
// Once per login: register the target, then prefetch its decisions.
_ = await fireweave.identify("user_42", options: RegisterTargetOptions(
kind: .user, properties: ["plan": "pro"]
))
// Reads are synchronous lookups in that prefetched cache.
let enabled = fireweave.controlPoints.getBooleanValue("new-checkout", default: false)
print("new-checkout: \(enabled)")
await fireweave.shutdown()Dart · Flutter (Android, iOS, macOS, Windows, Linux, web) · Dart VM
# Not on pub.dev yet: clone next to your app and depend on it by path
dependencies:
fireweave:
path: ../fireweave-sdk/sdks/dartimport 'package:fireweave/fireweave.dart';
final fw = await initFireweave(InitFireweaveOptions.remote(
apiKey: 'project-api-key_...',
apiUrl: 'https://app-server.fireweave.ai',
context: EvaluationContext(targetingKey: deviceId), // prefetch under a stable key
));
// Once per login: register the target, then prefetch its decisions.
await fw.identify('user_42',
options: const RegisterTargetOptions(properties: {'plan': 'pro'}));
// Inside build(): synchronous, never throws.
final enabled = fw.controlPoints.getBooleanValue('new-checkout', false);
await fw.shutdown();