Local-first CLI and Python package for Neksus JobSpec files

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for StefanRobertStegaru from gravatar.com StefanRobertStegaru

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License Expression: AGPL-3.0-or-later
    SPDX License Expression
  • Author: Neksus Team
  • Tags cli , jobspec , pydantic , typer , yaml
  • Requires: Python >=3.10
  • Provides-Extra: dev , mcp
Classifiers
Report project as malware

Project description

Neksus JobSpec

PyPI version CI docs.jobspec.neksusai.com

Neksus JobSpec is a local-first Python package and CLI for creating structured, branded, machine-readable job campaign pages from YAML.

Product Boundary

Included in the free/core package:

  • local CLI
  • local Python API
  • local rendering/export/feed/sitemap
  • optional local stdio MCP server
  • assistant prompt packs in skills/

Not included:

  • hosted SaaS/API
  • authentication
  • candidate collection/ATS workflows
  • CV upload/parsing
  • payments
  • direct LinkedIn API posting

LinkedIn-ready JSON export is a data profile only.

Installation

pip install neksus-jobspec

Optional MCP support:

pip install "neksus-jobspec[mcp]"

Basic CLI Usage

neksus-jobspec --help
neksus-jobspec init
neksus-jobspec spec new backend-engineer
neksus-jobspec spec validate jobspecs/backend-engineer.jobspec.yaml

Doctor Command

neksus-jobspec doctor
neksus-jobspec doctor --json

Spec Lint and Status

neksus-jobspec spec lint examples/startup-engineer.jobspec.yaml
neksus-jobspec spec status examples/startup-engineer.jobspec.yaml

spec lint emits advisory quality warnings while schema-invalid specs still fail.

Local Preview

neksus-jobspec spec preview examples/startup-engineer.jobspec.yaml
neksus-jobspec spec preview examples/startup-engineer.jobspec.yaml --theme classic --port 8765 --no-open

Themes

neksus-jobspec themes list
neksus-jobspec themes show classic
neksus-jobspec themes init my-theme
neksus-jobspec themes validate my-theme
neksus-jobspec themes validate examples/themes/minimal

Rendering and Exports

neksus-jobspec spec render examples/startup-engineer.jobspec.yaml --format web --output dist/startup-engineer.html
neksus-jobspec spec render examples/startup-engineer.jobspec.yaml --format json-ld --output dist/startup-engineer.jsonld

neksus-jobspec spec export examples/startup-engineer.jobspec.yaml --target generic-json --out dist/startup-engineer.json
neksus-jobspec spec export examples/startup-engineer.jobspec.yaml --target generic-xml --out dist/startup-engineer.xml
neksus-jobspec spec export examples/startup-engineer.jobspec.yaml --target linkedin-ready-json --out dist/startup-engineer-linkedin.json

Feeds and Sitemap

neksus-jobspec feed export "examples/*.jobspec.yaml" --target jobs-json --out dist/jobs.json
neksus-jobspec feed export "examples/*.jobspec.yaml" --target jobs-xml --out dist/jobs.xml
neksus-jobspec feed sitemap "examples/*.jobspec.yaml" --base-url https://company.dk/jobs --out dist/sitemap.xml

MCP Server (Optional)

neksus-jobspec-mcp

See docs:

Documentation

Development Checks

uv sync
uv run ruff check .
uv run ruff format --check .
uv run pytest
uv run python -m mkdocs build --strict

License

AGPL-3.0-or-later. See LICENSE.

Project details

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for StefanRobertStegaru from gravatar.com StefanRobertStegaru

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License Expression: AGPL-3.0-or-later
    SPDX License Expression
  • Author: Neksus Team
  • Tags cli , jobspec , pydantic , typer , yaml
  • Requires: Python >=3.10
  • Provides-Extra: dev , mcp
Classifiers

Release history Release notifications | RSS feed

This version

0.4.0

0.3.0

0.2.0

0.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

neksus_jobspec-0.4.0.tar.gz (68.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

neksus_jobspec-0.4.0-py3-none-any.whl (103.3 kB view details)

Uploaded Python 3

File details

Details for the file neksus_jobspec-0.4.0.tar.gz.

File metadata

  • Download URL: neksus_jobspec-0.4.0.tar.gz
  • Upload date:
  • Size: 68.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for neksus_jobspec-0.4.0.tar.gz
Algorithm Hash digest
SHA256 6685d508b53713a76f1b4b33a3b34f4fd7db4946de059c429f7466b0272968ce
MD5 a26a79b8ddc673aef0390a52ab948da5
BLAKE2b-256 def63a08459aa2ba3285248261ed9c7a092b5be1fdd759b509a1b286a66536cd

See more details on using hashes here.

Provenance

The following attestation bundles were made for neksus_jobspec-0.4.0.tar.gz:

Publisher: publish-pypi.yml on NeksusAI/NeksusJobSpec

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file neksus_jobspec-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: neksus_jobspec-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 103.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for neksus_jobspec-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a607b3443d3f71ea35db3f8210f36a79e94f141472aa06977d18b11f29a7272c
MD5 f7fcd4e6d5ee53ddf1b96ce7ce874601
BLAKE2b-256 8981fdbda16a2e1d90da9c6df45737f70e5ac2a6ebf8440e4ff108afd70da85c

See more details on using hashes here.

Provenance

The following attestation bundles were made for neksus_jobspec-0.4.0-py3-none-any.whl:

Publisher: publish-pypi.yml on NeksusAI/NeksusJobSpec

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page