osw
Python toolset for data processing, queries, wikicode generation and page manipulation within OpenSemanticLab.
Work with OpenSemanticLab instances the way you work with Python objects: load pages as typed pydantic entities, query with semantic search, generate models from the schemas stored in the wiki, and write changes back.
Documentation: https://opensemanticlab.github.io/osw-python/
Installation
pip install osw
Optional extras (osw[wikitext], osw[DB], osw[S3], osw[dataimport],
osw[UI], osw[mcp], osw[all]) are described in the
Get Started guide.
Quickstart
from osw.express import OswExpress
osw = OswExpress(domain="wiki-dev.open-semantic-lab.org")
instances = osw.site.semantic_search("[[Category:Item]]")
print(instances)
More runnable scripts live in examples/, and the Basics tutorial walks through the OpenSemanticLab data model.
Tools
Installing osw also installs an osw command line client, and the
osw[mcp] extra adds an MCP server that exposes a live instance to agent
clients such as Claude Code:
osw search ask '[[Category:Item]]' --limit 5
Commands, tools and their configuration are described in the Tools guide.
Logging
osw reports what it is doing on the osw logger at INFO by default. Levels,
the OSW_LOG_LEVEL environment variable and how to collect the records in your
own logging setup are described in the
Get Started guide.
Contributing
Contributions are welcome, see CONTRIBUTING.md.
Development setup, checks and tests are one command each: make install,
make check, make test.
Related projects
General features for object-oriented interaction with knowledge graphs live in the standalone package oold-python.
License
AGPL-3.0-or-later, see LICENSE.txt.
1 maintainer
Metadata
1 maintainer
Release files for osw 2.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| osw-2.8.1.tar.gz | 871.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| osw-2.8.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.1 MB
Release files / osw-2.8.1.tar.gz
| Download URL | osw-2.8.1.tar.gz |
|---|---|
| Size | 871.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b63e169024be4480d0668d4f6941f5f5430da9561bd01d8fa52eb91582bb8c2f
|
|
BLAKE2b-256 checksum How to use checksums |
3e638825f6578d03f69bae4d457054db03fc71b443eaa90cae1dc9faba3a09c8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.9.9 {"installer":{"name":"uv","version":"0.9.9"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / osw-2.8.1-py3-none-any.whl
| Download URL | osw-2.8.1-py3-none-any.whl |
|---|---|
| Size | 232.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7daf05be702ddc95a52eabb254415f16c4c5d9379bdf032082ef79dfb1ed96e1
|
|
BLAKE2b-256 checksum How to use checksums |
25ffd056627605ffe261a6df8b9a915710556a32e03d432f216a2e0020161046
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.9.9 {"installer":{"name":"uv","version":"0.9.9"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
