stam
STAM is a library for dealing with standoff annotations on text, this is the python binding.
Provided tools & services
stam
- Type
-
- Software Library
Tool suite: STAM
The following closely related tools are in a tool suite together with stam:
- Software Library
Created: 2023-01-03
Modified: 2025-11-10
stam v1.3.0
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. [view more]
- Annotating
- Textual and content analysis
- Textual and linguistic corpora
- annotation
- linguistics
- stand-off
- text
- text-annotation
- webannotation
Created: 2021-09-09
Modified: 2025-09-05
- Command-line Application
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:
Logs & Reviews
- Name
- Automatic software metadata validation report for stam 0.12.1
- Author
-
- codemetapy validator using software.ttl
- Date
- 2026-02-07 03:29: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 0.12.1 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. Warning: Documentation *SHOULD* be expressed (The metadata does express this currently, but something is wrong in the way it is expressed. Is the type/class valid?) 3. Info: Reference publications *SHOULD* be expressed, if any (This is missing in the metadata)
- Rating
(log file starts at Sat Feb 7 03:29:01 UTC 2026)
[harvester info] --> Processing stam-python (https://github.com/annotation/stam-python) [Sat Feb 7 03:29:01 UTC 2026]
[harvester info] Git updating cached clone of https://github.com/annotation/stam-python...
[harvester info] Found release v0.12.1
[harvester info] Using 'v0.12.1'
[harvester info] Git reference: v0.12.1
[harvester info] Scanning directory /tmp/codemeta-harvester.cache/stam-python for harvestable resources...
[harvester info] found codemeta-harvest.json for stam-python (md5sum 47f7539dabba7c4fffebf125100d8e7a); values in here take precendence over (override) those in later detection stages
[harvester info] found python setup for stam-python, converting to codemeta
[harvester info] found Cargo.toml (rust) for stam-python, converting to codemeta
[harvester info] Looking for license....
[harvester info] Found license GPL-3.0-only
[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: 2023-01-31T14:47:01Z+0100, date modified: 2026-01-05T14:56:31Z+0100
[harvester info] Querying Github/GitLab API (https://github.com/annotation/stam-python)
[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.18154374
[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] Scraping title from https://stam-python.readthedocs.io
[harvester info] Found documentation at https://stam-python.readthedocs.io : "name": "STAM Library for Python - API Documentation — stam-python version = '0.9.1' documentation",
[harvester info] Falling back to git tag (v0.12.1) 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-python" --codeRepository "https://github.com/annotation/stam-python" --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-python.codemeta.json /tmp/codemeta-harvester.cache//tmp/99-version.stam-python.codemeta.json /tmp/codemeta-harvester.cache//tmp/99-repostatus.stam-python.codemeta.json /tmp/codemeta-harvester.cache//tmp/90-authors.stam-python.codemeta.json /tmp/codemeta-harvester.cache//tmp/50-documentation.stam-python.codemeta.json /tmp/codemeta-harvester.cache//tmp/43-releasenotes.stam-python.codemeta.json /tmp/codemeta-harvester.cache//tmp/41-readme.stam-python.codemeta.json /tmp/codemeta-harvester.cache//tmp/40-gitapi.stam-python.codemeta.json /tmp/codemeta-harvester.cache//tmp/39-gitdate.stam-python.codemeta.json /tmp/codemeta-harvester.cache//tmp/32-contributors.stam-python.codemeta.json /tmp/codemeta-harvester.cache//tmp/29-license.stam-python.codemeta.json /tmp/codemeta-harvester.cache//tmp/23-rust.stam-python.codemeta.json /tmp/codemeta-harvester.cache//tmp/20-python.stam-python.codemeta.json /tmp/codemeta-harvester.cache//tmp/11-trl.stam-python.codemeta.json /tmp/codemeta-harvester.cache//tmp/11-repostatus.stam-python.codemeta.json /tmp/codemeta-harvester.cache//tmp/10-harvest.stam-python.codemeta.json /tmp/codemeta-harvester.cache//tmp/05-repostatus.stam-python.codemeta.json /tmp/codemeta-harvester.cache//tmp/05-doi.stam-python.codemeta.json /tmp/codemeta-harvester.cache//tmp/04-applicationSuite.stam-python.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 18 files/sources but specified 0 input types! Automatically guessing types...
Detected input types: [('/tmp/codemeta-harvester.cache//tmp/99-version.stam-python.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/99-repostatus.stam-python.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/90-authors.stam-python.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/50-documentation.stam-python.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/43-releasenotes.stam-python.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/41-readme.stam-python.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/40-gitapi.stam-python.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/39-gitdate.stam-python.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/32-contributors.stam-python.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/29-license.stam-python.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/23-rust.stam-python.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/20-python.stam-python.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/11-trl.stam-python.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/11-repostatus.stam-python.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/10-harvest.stam-python.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/05-repostatus.stam-python.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/05-doi.stam-python.codemeta.json', 'json'), ('/tmp/codemeta-harvester.cache//tmp/04-applicationSuite.stam-python.codemeta.json', 'json')]
Adding to contextgraph: /tmp/turtle
Initial URI automatically generated, may be overriden later: https://tools.clariah.nl/stam-python
Processing source #1 of 18
Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/99-version.stam-python.codemeta.json
NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...
Injected (possibly temporary) URI https://tools.clariah.nl/stam-python
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] processed 1 new triples, total is now 2
Processing source #2 of 18
Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/99-repostatus.stam-python.codemeta.json
NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...
Injected (possibly temporary) URI https://tools.clariah.nl/stam-python
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] processed 1 new triples, total is now 3
Processing source #3 of 18
Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/90-authors.stam-python.codemeta.json
Found main resource with URI https://tools.clariah.nl/stam-python.topcontributor/snapshot
Injected (possibly temporary) URI https://tools.clariah.nl/stam-python
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] processed 8 new triples, total is now 10
Processing source #4 of 18
Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/50-documentation.stam-python.codemeta.json
NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...
Injected (possibly temporary) URI https://tools.clariah.nl/stam-python
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] processed 4 new triples, total is now 14
Processing source #5 of 18
Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/43-releasenotes.stam-python.codemeta.json
NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...
Injected (possibly temporary) URI https://tools.clariah.nl/stam-python
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] processed 2 new triples, total is now 16
Processing source #6 of 18
Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/41-readme.stam-python.codemeta.json
NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...
Injected (possibly temporary) URI https://tools.clariah.nl/stam-python
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] processed 1 new triples, total is now 17
Processing source #7 of 18
Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/40-gitapi.stam-python.codemeta.json
Found main resource with URI https://tools.clariah.nl/stam-python/snapshot
Injected (possibly temporary) URI https://tools.clariah.nl/stam-python
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] processed 18 new triples, total is now 34
Processing source #8 of 18
Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/39-gitdate.stam-python.codemeta.json
NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...
Injected (possibly temporary) URI https://tools.clariah.nl/stam-python
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] overriding old http://schema.org/dateCreated (2023-02-07T13:18:02Z -> 2023-01-31T14:47:01Z+0100)
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] overriding old http://schema.org/dateModified (2026-01-05T14:05:07Z -> 2026-01-05T14:56:31Z+0100)
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] processed 2 new triples, total is now 34
Processing source #9 of 18
Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/32-contributors.stam-python.codemeta.json
Found main resource with URI https://tools.clariah.nl/stam-python.contributors/snapshot
Injected (possibly temporary) URI https://tools.clariah.nl/stam-python
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] processed 14 new triples, total is now 41
Processing source #10 of 18
Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/29-license.stam-python.codemeta.json
NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...
Injected (possibly temporary) URI https://tools.clariah.nl/stam-python
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] overriding old http://schema.org/license (http://spdx.org/licenses/GPL-3.0-only -> GPL-3.0-only)
[CODEMETA CORRECTION (https://tools.clariah.nl/stam-python)] automatically converting license to spdx URI
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] processed 1 new triples, total is now 41
Processing source #11 of 18
Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/23-rust.stam-python.codemeta.json
Found main resource with URI https://tools.clariah.nl/cargo.toml/0.12.1
Injected (possibly temporary) URI https://tools.clariah.nl/stam-python
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] overriding old http://schema.org/description (Python binding to work with STAM, the Standoff Text Annotation Model, from Python. Written in Rust. -> STAM is a library for dealing with standoff annotations on text, this is the python binding.)
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] overriding old http://schema.org/keywords (python -> annotation)
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] overriding old http://schema.org/keywords (library -> annotation)
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] overriding old https://codemeta.github.io/terms/readme (https://github.com/annotation/stam-python/blob/v0.12.1//README.md -> https://tools.clariah.nl/README.md)
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] overriding old http://schema.org/softwareHelp (https://stam-python.readthedocs.io -> https://stam-python.readthedocs.io/)
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] overriding old http://schema.org/version (v0.12.1 -> 0.12.1)
[CODEMETA COMPOSITION (https://tools.clariah.nl/stam-python)] processed 43 new triples, total is now 63
Processing source #12 of 18
Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/20-python.stam-python.codemeta.json
Found main resource with URI https://tools.clariah.nl/stam/snapshot
Injected (possibly temporary) URI https://tools.clariah.nl/stam-python
[CODEMETA COMPOSITION (stam)] overriding old http://schema.org/name (stam-python -> stam)
[CODEMETA COMPOSITION (stam)] processed 4 new triples, total is now 65
Processing source #13 of 18
Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/11-trl.stam-python.codemeta.json
NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...
Injected (possibly temporary) URI https://tools.clariah.nl/stam-python
[CODEMETA COMPOSITION (stam)] processed 1 new triples, total is now 66
Processing source #14 of 18
Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/11-repostatus.stam-python.codemeta.json
NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...
Injected (possibly temporary) URI https://tools.clariah.nl/stam-python
[CODEMETA COMPOSITION (stam)] processed 1 new triples, total is now 66
Processing source #15 of 18
Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/10-harvest.stam-python.codemeta.json
NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...
Injected (possibly temporary) URI https://tools.clariah.nl/stam-python
[CODEMETA COMPOSITION (stam)] overriding old http://schema.org/producer (https://tools.clariah.nl/org/annotation -> https://tools.clariah.nl/stub/H540c6bc3cf6a3cbd)
[CODEMETA COMPOSITION (stam)] processed 15 new triples, total is now 80
Processing source #16 of 18
Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/05-repostatus.stam-python.codemeta.json
NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...
Injected (possibly temporary) URI https://tools.clariah.nl/stam-python
[CODEMETA COMPOSITION (stam)] processed 1 new triples, total is now 80
Processing source #17 of 18
Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/05-doi.stam-python.codemeta.json
NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...
Injected (possibly temporary) URI https://tools.clariah.nl/stam-python
[CODEMETA COMPOSITION (stam)] overriding old http://schema.org/identifier (stam -> )
[CODEMETA COMPOSITION (stam)] processed 5 new triples, total is now 84
Processing source #18 of 18
Parsing json-ld file from /tmp/codemeta-harvester.cache//tmp/04-applicationSuite.stam-python.codemeta.json
NOTE: Not a valid JSON-LD document, @context missing! Attempting to inject automatically...
Injected (possibly temporary) URI https://tools.clariah.nl/stam-python
[CODEMETA COMPOSITION (https://tools.clariah.nl/stub/H-2558d12b6a11e182)] processed 1 new triples, total is now 85
Remapping URI to (possibly) new identifier and version component: https://tools.clariah.nl/stam-python -> https://tools.clariah.nl/stam-python/0.12.1
[CODEMETA VALIDATION (stam-python)] done
[CODEMETA ENRICHMENT (stam-python)] Guessing interface type https://w3id.org/software-types#SoftwareLibrary based on clues
[CODEMETA ENRICHMENT (stam-python)] considering first author as maintainer
VALIDATION https://tools.clariah.nl/stam-python/0.12.1 #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-python/0.12.1 #2: Warning: Documentation *SHOULD* be expressed (The metadata does express this currently, but something is wrong in the way it is expressed. Is the type/class valid?)
VALIDATION https://tools.clariah.nl/stam-python/0.12.1 #3: Info: Reference publications *SHOULD* be expressed, if any (This is missing in the metadata)
-- end log --
[harvester info] Output written to /tmp/out/stam-python.codemeta.json
[harvester info] <-- Finished processing stam-python (https://github.com/annotation/stam-python) [Sat Feb 7 03:29:30 UTC 2026]
Metadata Properties
- Version
- 0.12.1 (release notes)
- Interface types
-
- Software Library
- Software website
- Source code repository
- https://github.com/annotation/stam-python
- Category
-
- Annotating
- Textual and content analysis
- Textual and linguistic corpora
- Keywords
-
- annotation
- linguistics
- nlp
- standoff
- text-processing
- Development Status
-
-
- Issue Tracker (Support)
- https://github.com/annotation/stam-python/issues
- Documentation
- License
- Maintainer(s)
-
- Maarten van Gompel <proycon@anaproy.nl> (KNAW Humanities Cluster) (KNAW Humanities Cluster & CLST, Radboud University)
- Contributor(s)
-
- Bram Buitendijk
- Maarten van Gompel <proycon@anaproy.nl> (KNAW Humanities Cluster) (KNAW Humanities Cluster & CLST, Radboud University)
- Producer
- Programming Language
-
- Rust
- Runtime Platform
-
- Python 3
- Software dependencies
-
- pyo3
- rayon
- stam
- stam-tools
- Metadata validation
- Created
- 2023-01-31 14:47:01 +0100
- Last modified
-
2026-01-05 14:56:31 +0100
