stam

stam
Stand-off Text Annotation Model (STAM) is a data model for stand-off-text annotation where any information on a text is represented as an annotation. This repository contains the model's full specification, extensions, schemas, examples and documentation.
Go to the software website https://annotation.github.io/stam

Tool suite: STAM

The following closely related tools are in a tool suite together with stam:

  • Software Library
  • 7 - Release Candidate: Technology ready enough and in initial use by end-users in intended scholarly environments. Further validation may be in progress.
  • Active: The project has reached a stable, usable state and is being actively developed.
thumbnail/logo

stam 0.18.6

STAM is a powerful library for dealing with stand-off annotations on text. This is the Rust library. [view more]
  • Annotating
  • Textual and content analysis
  • Textual and linguistic corpora
  • annotation
  • linguistics
  • nlp
  • standoff
  • text-processing
Created: 2023-01-03
Modified: 2025-11-10
  • Software Library
  • 7 - Release Candidate: Technology ready enough and in initial use by end-users in intended scholarly environments. Further validation may be in progress.
  • Active: The project has reached a stable, usable state and is being actively developed.
thumbnail/logo

stam 0.12.1

STAM is a library for dealing with standoff annotations on text, this is the python binding. [view more]
  • Annotating
  • Textual and content analysis
  • Textual and linguistic corpora
  • annotation
  • linguistics
  • nlp
  • standoff
  • text-processing
Created: 2023-01-31
Modified: 2026-01-05
  • Command-line Application
  • 7 - Release Candidate: Technology ready enough and in initial use by end-users in intended scholarly environments. Further validation may be in progress.
  • Active: The project has reached a stable, usable state and is being actively developed.

stam-tools 0.14.1

Command-line tools for working with stand-off annotations on text (STAM) [view more]
  • Annotating
  • Textual and content analysis
  • Textual and linguistic corpora
  • annotation
  • linguistics
  • nlp
  • standoff
  • text-processing
Created: 2023-03-21
Modified: 2026-02-04

Citation

You can cite this software using the following citation generated from its metadata:

(2025) stam v1.3.0 .
  • KNAW Humanities Cluster
.

Logs & Reviews

Name
Automatic software metadata validation report for stam v1.3.0
Author
  • codemetapy validator using software.ttl
Date
2026-02-07 03:30:30
Review
Please consult the CLARIAH Software Metadata Requirements at https://github.com/CLARIAH/clariah-plus/blob/main/requirements/software-metadata-requirements.md for an in-depth explanation of any found problems

Validation of stam v1.3.0 was successful (score=3/5), but there are some warnings which should be addressed:

1. Info: Software source code *SHOULD* link to a continuous integration service that builds the software and runs the software's tests (This is missing in the metadata)
2. Info: Software source code *MAY* express the programming language(s) used (This is missing in the metadata)
3. Info: An interface type *SHOULD* be expressed: Software source code should define one or more target products that are the resulting software applications offering specific interfaces (This is missing in the metadata)
4. Warning: Documentation *SHOULD* be expressed (This is missing in the metadata)
5. Info: Reference publications *SHOULD* be expressed, if any (This is missing in the metadata)
Rating
★ ★ ★ ☆ ☆ 
(log file starts at Sat Feb  7 03:30:14 UTC 2026)

[harvester info] --> Processing stam (https://github.com/annotation/stam) [Sat Feb  7 03:30:14 UTC 2026]

[harvester info] Git updating cached clone of https://github.com/annotation/stam...

[harvester info] Found release v1.3.0

[harvester info] Using 'v1.3.0'

[harvester info] Git reference: v1.3.0

[harvester info] Scanning directory /tmp/codemeta-harvester.cache/stam for harvestable resources...

[harvester info] found codemeta-harvest.json for stam (md5sum e892bb9a9ee183702e914f9033c926e4); values in here take precendence over (override) those in later detection stages

[harvester info] Looking for license....

[harvester info] No license file found

[harvester info] Getting contributors from git...

[harvester info] Getting top contributor from git...

[harvester info] Git top contributor Maarten van Gompel <proycon@anaproy.nl> will be assigned as author (and maintainer) if none are found in the metadata

[harvester info] Extracting last and first commit date from git log....

[harvester info] Date created: 2021-09-09T17:02:05Z+0200, date modified: 2025-09-05T23:19:12Z+0200

[harvester info] Querying Github/GitLab API (https://github.com/annotation/stam)

[harvester info] Adding URL for found README: README.md

[harvester info] Found releaseNotes

[harvester info] Querying Zenodo API for DOI (access token provided)...

[harvester info] Found DOI https://doi.org/10.5281/zenodo.17079283

[harvester info] Looking for TRL information in README.md...

[harvester info] Found TRL https://w3id.org/research-technology-readiness-levels#Level7ReleaseCandidate

[harvester info] Looking for repostatus information in README.md...

[harvester info] Found repostatus https://www.repostatus.org/#active

[harvester info] Looking for continuous integration information in README.md...

[harvester info] Looking for documentation links in README.md...

[harvester info] Falling back to git tag (v1.3.0) if no version number is specified...

[harvester info] Inferring repostatus information from git activity (used only as a fallback if not explicitly provided)...

[harvester info] Inferred repostatus https://www.repostatus.org/#active

[harvester info] Looking for repostatus information in README.md in master branch...

[harvester info] Found repostatus (master branch) https://www.repostatus.org/#active

[harvester info] Setting group STAM

[harvester info] Reconciliating: codemetapy  --baseuri https://tools.clariah.nl --baseuri https://tools.clariah.nl --includecontext --addcontext https://w3id.org/nwo-research-fields --addcontext https://w3id.org/research-technology-readiness-levels --addcontextgraph https://vocabs.dariah.eu/rest/v1/tadirah/data?format=text/turtle --trl --identifier "stam" --codeRepository "https://github.com/annotation/stam" --validate /etc/software.ttl --released --enrich --textv "Please consult the CLARIAH Software Metadata Requirements at https://github.com/CLARIAH/clariah-plus/blob/main/requirements/software-metadata-requirements.md for an in-depth explanation of any found problems" -O /tmp/out/stam.codemeta.json /tmp/codemeta-harvester.cache//tmp/99-version.stam.codemeta.json /tmp/codemeta-harvester.cache//tmp/99-repostatus.stam.codemeta.json /tmp/codemeta-harvester.cache//tmp/90-authors.stam.codemeta.json /tmp/codemeta-harvester.cache//tmp/43-releasenotes.stam.codemeta.json /tmp/codemeta-harvester.cache//tmp/41-readme.stam.codemeta.json /tmp/codemeta-harvester.cache//tmp/40-gitapi.stam.codemeta.json /tmp/codemeta-harvester.cache//tmp/39-gitdate.stam.codemeta.json /tmp/codemeta-harvester.cache//tmp/32-contributors.stam.codemeta.json /tmp/codemeta-harvester.cache//tmp/11-trl.stam.codemeta.json /tmp/codemeta-harvester.cache//tmp/11-repostatus.stam.codemeta.json /tmp/codemeta-harvester.cache//tmp/10-harvest.stam.codemeta.json /tmp/codemeta-harvester.cache//tmp/05-repostatus.stam.codemeta.json /tmp/codemeta-harvester.cache//tmp/05-doi.stam.codemeta.json /tmp/codemeta-harvester.cache//tmp/04-applicationSuite.stam.codemeta.json 

-- begin log --

/usr/lib/python3.12/site-packages/pyshacl/extras/__init__.py:6: UserWarning: pkg_resources is deprecated as an API. See https://setuptools.pypa.io/en/latest/pkg_resources.html. The pkg_resources package is slated for removal as early as 2025-11-30. Refrain from using this package or pin to Setuptools<81.

  import pkg_resources

Passed 14 files/sources but specified 0 input types! Automatically guessing types...

Detected input types: [('/tmp/codemeta-harvester.cache//tmp/99-version.stam.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/99-repostatus.stam.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/90-authors.stam.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/43-releasenotes.stam.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/41-readme.stam.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/40-gitapi.stam.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/39-gitdate.stam.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/32-contributors.stam.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/11-trl.stam.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/11-repostatus.stam.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/10-harvest.stam.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/05-repostatus.stam.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/05-doi.stam.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/04-applicationSuite.stam.codemeta.json', 'json')]

Adding to contextgraph: /tmp/turtle

Initial URI automatically generated, may be overriden later: https://tools.clariah.nl/stam

Processing source #1 of 14

Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/99-version.stam.codemeta.json

    NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...

    Injected (possibly temporary) URI https://tools.clariah.nl/stam

[CODEMETA COMPOSITION (https://tools.clariah.nl/stam)] processed 1 new triples, total is now 2

Processing source #2 of 14

Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/99-repostatus.stam.codemeta.json

    NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...

    Injected (possibly temporary) URI https://tools.clariah.nl/stam

[CODEMETA COMPOSITION (https://tools.clariah.nl/stam)] processed 1 new triples, total is now 3

Processing source #3 of 14

Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/90-authors.stam.codemeta.json

    Found main resource with URI https://tools.clariah.nl/stam.topcontributor/snapshot

    Injected (possibly temporary) URI https://tools.clariah.nl/stam

[CODEMETA COMPOSITION (https://tools.clariah.nl/stam)] processed 8 new triples, total is now 10

Processing source #4 of 14

Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/43-releasenotes.stam.codemeta.json

    NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...

    Injected (possibly temporary) URI https://tools.clariah.nl/stam

[CODEMETA COMPOSITION (https://tools.clariah.nl/stam)] processed 2 new triples, total is now 12

Processing source #5 of 14

Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/41-readme.stam.codemeta.json

    NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...

    Injected (possibly temporary) URI https://tools.clariah.nl/stam

[CODEMETA COMPOSITION (https://tools.clariah.nl/stam)] processed 1 new triples, total is now 13

Processing source #6 of 14

Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/40-gitapi.stam.codemeta.json

    Found main resource with URI https://tools.clariah.nl/stam/snapshot

    Injected (possibly temporary) URI https://tools.clariah.nl/stam

[CODEMETA COMPOSITION (https://tools.clariah.nl/stam)] processed 20 new triples, total is now 32

Processing source #7 of 14

Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/39-gitdate.stam.codemeta.json

    NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...

    Injected (possibly temporary) URI https://tools.clariah.nl/stam

[CODEMETA COMPOSITION (https://tools.clariah.nl/stam)] overriding old http://schema.org/dateCreated (2022-09-19T16:27:57Z -> 2021-09-09T17:02:05Z+0200)

[CODEMETA COMPOSITION (https://tools.clariah.nl/stam)] overriding old http://schema.org/dateModified (2025-12-05T10:34:24Z -> 2025-09-05T23:19:12Z+0200)

[CODEMETA COMPOSITION (https://tools.clariah.nl/stam)] processed 2 new triples, total is now 32

Processing source #8 of 14

Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/32-contributors.stam.codemeta.json

    Found main resource with URI https://tools.clariah.nl/stam.contributors/snapshot

    Injected (possibly temporary) URI https://tools.clariah.nl/stam

[CODEMETA COMPOSITION (https://tools.clariah.nl/stam)] processed 26 new triples, total is now 53

Processing source #9 of 14

Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/11-trl.stam.codemeta.json

    NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...

    Injected (possibly temporary) URI https://tools.clariah.nl/stam

[CODEMETA COMPOSITION (https://tools.clariah.nl/stam)] processed 1 new triples, total is now 54

Processing source #10 of 14

Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/11-repostatus.stam.codemeta.json

    NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...

    Injected (possibly temporary) URI https://tools.clariah.nl/stam

[CODEMETA COMPOSITION (https://tools.clariah.nl/stam)] processed 1 new triples, total is now 54

Processing source #11 of 14

Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/10-harvest.stam.codemeta.json

    NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...

    Injected (possibly temporary) URI https://tools.clariah.nl/stam

[CODEMETA COMPOSITION (https://tools.clariah.nl/stam)] overriding old http://schema.org/producer (https://tools.clariah.nl/org/annotation -> https://tools.clariah.nl/stub/H-1437a56d6d04d1d9)

[CODEMETA COMPOSITION (https://tools.clariah.nl/stam)] overriding old https://codemeta.github.io/terms/developmentStatus (https://w3id.org/research-technology-readiness-levels#Level7ReleaseCandidate -> https://w3id.org/research-technology-readiness-levels#Stage3Experimental)

[CODEMETA COMPOSITION (https://tools.clariah.nl/stam)] overriding old http://schema.org/url (https://annotation.github.io/stam/ -> https://annotation.github.io/stam)

[CODEMETA COMPOSITION (https://tools.clariah.nl/stam)] processed 18 new triples, total is now 68

Processing source #12 of 14

Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/05-repostatus.stam.codemeta.json

    NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...

    Injected (possibly temporary) URI https://tools.clariah.nl/stam

[CODEMETA COMPOSITION (https://tools.clariah.nl/stam)] processed 1 new triples, total is now 68

Processing source #13 of 14

Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/05-doi.stam.codemeta.json

    NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...

    Injected (possibly temporary) URI https://tools.clariah.nl/stam

[CODEMETA COMPOSITION (https://tools.clariah.nl/stam)] processed 5 new triples, total is now 73

Processing source #14 of 14

Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/04-applicationSuite.stam.codemeta.json

    NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...

    Injected (possibly temporary) URI https://tools.clariah.nl/stam

[CODEMETA COMPOSITION (https://tools.clariah.nl/stub/H-5c315a9bb6708a30)] processed 1 new triples, total is now 74

Remapping URI to (possibly) new identifier and version component: https://tools.clariah.nl/stam -> https://tools.clariah.nl/stam/v1.3.0

[CODEMETA VALIDATION (stam)] done

[CODEMETA ENRICHMENT (stam)] considering first author as maintainer

VALIDATION https://tools.clariah.nl/stam/v1.3.0 #1: Info: Software source code *SHOULD* link to a continuous integration service that builds the software and runs the software's tests (This is missing in the metadata)

VALIDATION https://tools.clariah.nl/stam/v1.3.0 #2: Info: Software source code *MAY* express the programming language(s) used (This is missing in the metadata)

VALIDATION https://tools.clariah.nl/stam/v1.3.0 #3: Info: An interface type *SHOULD* be expressed: Software source code should define one or more target products that are the resulting software applications offering specific interfaces (This is missing in the metadata)

VALIDATION https://tools.clariah.nl/stam/v1.3.0 #4: Warning: Documentation *SHOULD* be expressed (This is missing in the metadata)

VALIDATION https://tools.clariah.nl/stam/v1.3.0 #5: Info: Reference publications *SHOULD* be expressed, if any (This is missing in the metadata)

-- end log --

[harvester info] Output written to /tmp/out/stam.codemeta.json

[harvester info] <-- Finished processing stam (https://github.com/annotation/stam) [Sat Feb  7 03:30:31 UTC 2026]

Metadata Properties

Version
v1.3.0 (release notes)
Interface types
  • Unknown
Software website
Source code repository
 https://github.com/annotation/stam Stars are an indicator of the popularity of this project on GitHub
Category
  • Annotating
  • Textual and content analysis
  • Textual and linguistic corpora
Keywords
  • annotation
  • linguistics
  • stand-off
  • text
  • text-annotation
  • webannotation
Development Status
  • Experimental: The technology is implemented and ready for experimental settings (beta), but requires further work and validation.
  • Active: The project has reached a stable, usable state and is being actively developed.
Issue Tracker (Support)
https://github.com/annotation/stam/issues The number of open issues on the issue tracker The number of closes issues on the issue tracker
Documentation
License
Author(s)
Maintainer(s)
Contributor(s)
Producer
Metadata validation
★ ★ ★ ☆ ☆
Created
2021-09-09 17:02:05 +0200
Last modified
2025-09-05 23:19:12 +0200 Last commit (main branch). Gives an indication of project development activity and rough indication of how up-to-date the latest release is. Number of commits since the last release. Gives an indication of project development activity and rough indication of how up-to-date the latest release is.