Documentation

The Library

The Library is your central data hub for all videos, annotations, vocabularies, and documents.

Videos

Video Requirements

  • Minimum recommended quality: HD (1280×720)
  • Supports all perspectives (first-person, stationary, overhead, etc.)
  • Any video recording devices: GoPro, smartphones, smart glasses, stationary cameras, or similar

Importing Videos

Single Video Upload

  1. Go to Library → Videos.
  2. Click Upload in the upper right corner.
  3. Select Upload new video.
  4. Fill out the upload form.
  5. Confirm to start the upload.

After upload, you can link the video to one or more projects for annotation.

Multiple Videos (Batch Upload)

For larger datasets or frequent imports, contact support@ramblr.ai to set up a secure blob storage job.

Documents

Documents serve two key purposes:

  • As input data for chatbot or context-based agent development.
  • As source material for generating vocabularies and annotation categories.

Uploading Documents

Coming Soon

You’ll soon be able to upload documents such as PDFs, manuals, or SOPs directly through the Library → Documents section.

Until this feature is fully released, please contact support@ramblr.ai for document uploads.

Uploading Plain Text

  1. Go to Library → Documents.
  2. Click Upload in the upper right corner.
  3. Fill out the upload form and confirm to start the upload.

Vocabulary

A vocabulary defines the categories and activities used for both human and machine annotations. It ensures consistency and precision by guiding how objects, actions, or events are identified during annotation.

You can either:

  • Use predefined categories from the built-in open-world vocabulary, or
  • Create your own custom categories tailored to your specific use case.

Create a Vocabulary

  1. Go to Library → Vocabularies and click New Vocabulary.
  2. Enter a name and description.
  3. Click the newly created vocabulary, then select Edit.

Add Categories

  • Type into the Add a category field (e.g., kettle, mug, stove).
  • Suggestions from the open-world vocabulary may appear, these include synonyms and descriptions. Use them if they fit your purpose.
  • If no suggestion appears, create a new category manually.
  • You can add synonyms and descriptions in the panel on the right for each category.

Add Activities

  • Open the Activities tab in the same vocabulary.
  • Add activities (e.g., specific work steps) just like categories.
  • Activities help guide annotators and AI systems during annotation.

Add Relations and Attributes

Coming Soon

You’ll soon be able to define custom relations and attributes directly within your vocabulary. This allows you to limit automatic generation during annotation to only the structures you’ve predefined — speeding up the annotation process and reducing manual work.

By constraining AI outputs to your defined relations and attributes, you ensure consistent, reliable annotations and avoid potential model hallucinations.

Link the Vocabulary to a Project

  1. Go to your project.
  2. Open Settings → Annotation Scope → Vocabulary.
  3. Select your vocabulary and enable Use vocabulary suggestions.

Once linked, the vocabulary remains editable. Any updates are reflected automatically during annotation.

Auto-Generated Vocabularies

Coming Soon

Auto-generate your vocabulary (object categories, activities, relations and attributes) based on provided manuals, instructions, and PDFs.