Track and version objects

​

Objects

• Datasets: Collections of examples for evaluation
• Models: Configurations and parameters for your LLM logic
• Prompts: Versioned prompt templates

dataset = weave.Dataset(
    name="test-cases",
    rows=[
        {"input": "What is 2+2?", "expected": "4"},
        {"input": "What is the capital of France?", "expected": "Paris"},
    ]
)
weave.publish(dataset)

​

Publishing an object

import weave
weave.init("your-team-name/your-project-name")
# Save a list, giving it the name 'cat-names'
weave.publish(['felix', 'jimbo', 'billie'], 'cat-names')

import * as weave from 'weave'

const client = await weave.init("your-team-name/your-project-name")

// Save an array, giving it the name 'cat-names'
client.publish(['felix', 'jimbo', 'billie'], 'cat-names')

​

Get an object back

weave.init("your-team-name/your-project-name")
cat_names = weave.ref('cat-names').get()

This feature is not available in TypeScript yet.

​

Delete an object

weave.init("your-team-name/your-project-name")
cat_names_ref = weave.ref('cat-names:v1')
cat_names_ref.delete()

This feature is not available in TypeScript yet.

​

Constructing object refs

weave:///<your-team-name>/<your-project-name>/object/<object_name>:<object_version>

• your-team-name: W&B entity (username or team name)
• your-project-name: W&B project
• object_name: object name
• object_version: either a version hash, a string like v0 or v1, or an alias like :latest. All objects have the :latest alias.

• weave.ref(<name>): Retrieves the :latest version of an object. Requires calling weave.init(...).
• weave.ref(<name>:<version>): Retrieves the specified version of an object. Requires calling weave.init(...).
• weave.ref(<fully_qualified_ref_uri>): Retrieves the object located at the specified fully qualified object ref URI. Does not require calling weave.init().