Upload 8 files

LICENSE.md

@@ -0,0 +1,36 @@
+# JOA Model License, version 1.0
+
+**Status: in effect from 24 October 2026.** This licence governs the model weights published in this repository.
+
+Licensor: Loukas Tzekos, trading as Job Opportunities API (JOA), sole proprietorship, Didaskalisis Papathanasiou Vas. 79, 54629 Thessaloniki, Greece, VAT EL117613696. Legal matters: luca@tzekos.eu.
+
+"The Model" means the weights and adapters of JOA Small (and of JOA Small, JOA Advance and JOA Deep generally) as released by the Licensor, and any files released with them. "Derivative" means any model or adapter made from the Model, for example by fine-tuning, merging, quantising or distillation.
+
+## 1. What you may do
+
+You may use, copy, modify, fine-tune, merge, quantise, distribute and sell the Model and Derivatives, and use them in any product or service, including commercial and hosted services. The licence is free of charge, worldwide, non-exclusive and lasts as long as the rights it covers.
+
+## 2. Conditions
+
+These conditions apply when you distribute the Model or a Derivative, or make a product or service that uses them available to anyone outside your own organisation (including through an app, website or hosted API). Purely internal use has no conditions beyond sections 2.4 and 3.
+
+1. **Keep the base model's licence.** The Model is built on a base model licensed under the Apache License, Version 2.0. Include that licence and any copyright and NOTICE text of the base model, and state that the weights were modified. Nothing in this licence limits the rights you have in the base model itself, obtained from its publisher, under its own licence.
+2. **Give visible credit.** Display the line "Built with JOA Small by Job Opportunities API" with a link to https://jobopportunitiesapi.org, where users of your product or service can see it: in its documentation, its about page or its user interface. If you publish a Derivative, put the same line and link in its model card or README.
+3. **Pass this licence on.** Include a copy of this licence with every copy of the Model or a Derivative you distribute. You may license your own changes on your own terms, but these conditions continue to apply to the parts that come from the Model.
+4. **No implied endorsement.** You may say that your work is based on JOA Small. Do not name or present it in a way that suggests Job Opportunities API, IBM, Alibaba Cloud or the Qwen team made, endorse or support it. This licence grants no trademark rights.
+
+## 3. Outputs
+
+What you generate with the Model is yours. This licence puts no conditions on outputs.
+
+## 4. Ending and restoring the licence
+
+If you break a condition, your rights under this licence end automatically. They come back if you fix the breach within 30 days of becoming aware of it.
+
+## 5. No warranty
+
+The Model is provided "as is", without warranty of any kind. To the extent permitted by law, the Licensor is not liable for any damage arising from its use.
+
+## 6. Law
+
+This licence is governed by Greek law. This does not remove any rights consumers have under the law of their own country.

README.md

@@ -0,0 +1,57 @@
+---
+license: other
+license_name: joa-model-license
+license_link: LICENSE.md
+base_model: ibm-granite/granite-3.3-8b-instruct
+base_model_relation: adapter
+pipeline_tag: text-generation
+tags:
+- information-extraction
+- job-postings
+- lora
+---
+
+# JOA Advance v2: job-posting extraction model
+
+*Disclosure: Job Opportunities API (JOA, jobopportunitiesapi.org) is an independent data business that sells API access to job-posting data. AI helped run the experiments, check the numbers and draft this text; Loukas (Luca) Tzekos is editorially responsible. Contact: hello@jobopportunitiesapi.org.*
+
+**Status (24 October 2026): weights released.** This is a second-pass retrain of JOA Advance, trained 10 to 18 October 2026 on the same recipe as the first release. The model was trained and evaluated, and the evaluation below is unchanged from 6 October 2026. The weights are in this repository under the JOA Model License (LICENSE.md): any use, including commercial, with visible credit and a link.
+
+## What it does
+
+JOA Advance reads the text of one job posting and returns 11 structured fields as JSON: title, company, location, salary currency, minimum, maximum and period, seniority, remote type, posted date, and whether the poster is a staffing agency. It leaves a field empty when the posting does not state it. It answers directly, without a long reasoning trace.
+
+## How it was made
+
+- **Base model:** [ibm-granite/granite-3.3-8b-instruct](https://huggingface.co/ibm-granite/granite-3.3-8b-instruct) by IBM, licensed Apache 2.0.
+- **Method:** LoRA adapter (rank 16), one epoch, 38,488 training examples.
+- **Training data:** fields extracted by Qwen/Qwen3.5-27B (Apache 2.0) from job postings collected by Job Opportunities API (JOA), kept only when grounded in the posting text (for example, a title or salary that actually appears in it). The 250 arena listings and the 250 verification listings were excluded.
+- **Compute:** This work used the EuroHPC supercomputer Discoverer+ in Bulgaria, made available by the EuroHPC Joint Undertaking through an AI Factories Playground access allocation (project EHPC-AIF-2026PG01-1124).
+
+## Results
+
+**These weights have not been re-graded on the extraction arena.**
+
+The v1 release of this model was graded on 250 real job listings against two judge models, and those numbers are published on the v1 card. They are claims about the v1 weights only. Until we run the arena again on this variant, its quality is genuinely unknown, and we will not put a number on it that we have not measured.
+
+If you need a model with a published score today, use the v1 release. If you want to help us grade this one, the arena is open: https://huggingface.co/datasets/JobOpportunitiesAPI/joa-extraction-arena
+
+## Licence
+
+The weights are licensed under the **JOA Model License** (LICENSE.md in this repository):
+
+- You may use, modify, fine-tune, redistribute and sell JOA Advance, including in commercial and hosted products.
+- If you distribute it, or make a product or service that uses it available to others, show "Built with JOA Advance v2 by Job Opportunities API" with a link to https://jobopportunitiesapi.org in your documentation, about page or user interface, and in the model card of any derivative.
+- Keep the base model's Apache 2.0 licence and notices.
+- Do not imply endorsement.
+
+## Attribution
+
+JOA Advance v2 is a fine-tune of ibm-granite/granite-3.3-8b-instruct by IBM, used under the Apache License 2.0. It is not made, endorsed or supported by IBM. Built by Job Opportunities API (JOA), https://jobopportunitiesapi.org.
+
+## Contact
+
+- General: hello@jobopportunitiesapi.org
+- Legal matters: luca@tzekos.eu
+- Phone: +30 2311 113 603
+- Job Opportunities API (JOA) is a sole proprietorship of Loukas Tzekos, Didaskalisis Papathanasiou Vas. 79, 54629 Thessaloniki, Greece. VAT EL117613696.

adapter_config.json

@@ -0,0 +1,51 @@
+{
+  "alora_invocation_tokens": null,
+  "alpha_pattern": {},
+  "arrow_config": null,
+  "auto_mapping": null,
+  "base_model_name_or_path": "/valhalla/projects/ehpc-aif-2026pg01-1124/models/arena/ibm-granite__granite-3.3-8b-instruct",
+  "bias": "none",
+  "corda_config": null,
+  "ensure_weight_tying": false,
+  "eva_config": null,
+  "exclude_modules": null,
+  "fan_in_fan_out": false,
+  "inference_mode": true,
+  "init_lora_weights": true,
+  "kasa_config": null,
+  "layer_replication": null,
+  "layers_pattern": null,
+  "layers_to_transform": null,
+  "loftq_config": {},
+  "lora_alpha": 32,
+  "lora_bias": false,
+  "lora_dropout": 0.05,
+  "lora_ga_config": null,
+  "megatron_config": null,
+  "megatron_core": "megatron.core",
+  "modules_to_save": null,
+  "monteclora_config": null,
+  "peft_type": "LORA",
+  "peft_version": "0.21.0",
+  "qalora_group_size": 16,
+  "r": 16,
+  "rank_pattern": {},
+  "revision": null,
+  "target_modules": [
+    "up_proj",
+    "q_proj",
+    "gate_proj",
+    "k_proj",
+    "o_proj",
+    "v_proj",
+    "down_proj"
+  ],
+  "target_parameters": null,
+  "task_type": "CAUSAL_LM",
+  "trainable_token_indices": null,
+  "use_bdlora": null,
+  "use_dora": false,
+  "use_qalora": false,
+  "use_rslora": false,
+  "velora_config": null
+}

adapter_model.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5a536676f1f73075b83fde2977efd25cd8b164c5b21b11e74e6c3cda874633fb
+size 197993952

chat_template.jinja

@@ -0,0 +1,62 @@
+{# Alias tools -> available_tools #}
+{%- if tools and not available_tools -%}
+    {%- set available_tools = tools -%}
+{%- endif -%}
+{%- if messages[0]['role'] == 'system' %}
+     {%- set system_message = messages[0]['content'] %}
+     {%- set loop_messages = messages[1:] %}
+ {%- else %}
+     {%- set system_message = "Knowledge Cutoff Date: April 2024.
+Today's Date: " + strftime_now('%B %d, %Y') + ".
+You are Granite, developed by IBM." %}
+     {%- if available_tools and documents %}
+         {%- set system_message = system_message + " You are a helpful assistant with access to the following tools. When a tool is required to answer the user's query, respond only with <|tool_call|> followed by a JSON list of tools used. If a tool does not exist in the provided list of tools, notify the user that you do not have the ability to fulfill the request.
+Write the response to the user's input by strictly aligning with the facts in the provided documents. If the information needed to answer the question is not available in the documents, inform the user that the question cannot be answered based on the available data." %}
+     {%- elif available_tools %}
+         {%- set system_message = system_message + " You are a helpful assistant with access to the following tools. When a tool is required to answer the user's query, respond only with <|tool_call|> followed by a JSON list of tools used. If a tool does not exist in the provided list of tools, notify the user that you do not have the ability to fulfill the request." %}
+     {%- elif documents %}
+         {%- set system_message = system_message + " Write the response to the user's input by strictly aligning with the facts in the provided documents. If the information needed to answer the question is not available in the documents, inform the user that the question cannot be answered based on the available data." %}
+    {%- elif thinking %}
+    {%- set system_message = system_message + " You are a helpful AI assistant.
+Respond to every user query in a comprehensive and detailed way. You can write down your thoughts and reasoning process before responding. In the thought process, engage in a comprehensive cycle of analysis, summarization, exploration, reassessment, reflection, backtracing, and iteration to develop well-considered thinking process. In the response section, based on various attempts, explorations, and reflections from the thoughts section, systematically present the final solution that you deem correct. The response should summarize the thought process. Write your thoughts between <think></think> and write your response between <response></response> for each user query." %}
+     {%- else %}
+         {%- set system_message = system_message + " You are a helpful AI assistant." %}
+     {%- endif %}
+     {%- if 'citations' in controls and documents %}
+         {%- set system_message = system_message + '
+Use the symbols <|start_of_cite|> and <|end_of_cite|> to indicate when a fact comes from a document in the search result, e.g <|start_of_cite|> {document_id: 1}my fact <|end_of_cite|> for a fact from document 1. Afterwards, list all the citations with their corresponding documents in an ordered list.' %}
+     {%- endif %}
+     {%- if 'hallucinations' in controls and documents %}
+         {%- set system_message = system_message + '
+Finally, after the response is written, include a numbered list of sentences from the response with a corresponding risk value that are hallucinated and not based in the documents.' %}
+     {%- endif %}
+     {%- set loop_messages = messages %}
+ {%- endif %}
+ {{- '<|start_of_role|>system<|end_of_role|>' + system_message + '<|end_of_text|>
+' }}
+ {%- if available_tools %}
+     {{- '<|start_of_role|>available_tools<|end_of_role|>' }}
+     {{- available_tools | tojson(indent=4) }}
+     {{- '<|end_of_text|>
+' }}
+ {%- endif %}
+ {%- if documents %}
+     {%- for document in documents %}
+         {{- '<|start_of_role|>document {"document_id": "' + document['doc_id'] | string + '"}<|end_of_role|>
+' }}
+         {{- document['text'] }}
+         {{- '<|end_of_text|>
+' }}
+              {%- endfor %}
+ {%- endif %}
+ {%- for message in loop_messages %}
+     {{- '<|start_of_role|>' + message['role'] + '<|end_of_role|>' + message['content'] + '<|end_of_text|>
+' }}
+     {%- if loop.last and add_generation_prompt %}
+         {{- '<|start_of_role|>assistant' }}
+             {%- if controls %}
+                 {{- ' ' + controls | tojson()}}
+             {%- endif %}
+         {{- '<|end_of_role|>' }}
+     {%- endif %}
+ {%- endfor %}

tokenizer_config.json

@@ -0,0 +1,16 @@
+{
+  "add_prefix_space": false,
+  "backend": "tokenizers",
+  "bos_token": "<|end_of_text|>",
+  "clean_up_tokenization_spaces": true,
+  "eos_token": "<|end_of_text|>",
+  "errors": "replace",
+  "is_local": true,
+  "local_files_only": true,
+  "model_max_length": 9223372036854775807,
+  "pad_token": "<|end_of_text|>",
+  "padding_side": "left",
+  "tokenizer_class": "TokenizersBackend",
+  "unk_token": "<|end_of_text|>",
+  "vocab_size": 49152
+}

training_args.bin

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:db5b0c5ba9557209cefbe9d7d417f2bb724d1e759acee9fc715096ce18923e7b
+size 5265