File size: 2,675 Bytes
df57a6d
 
 
 
 
 
 
 
 
 
 
 
 
 
eca5751
 
 
 
df57a6d
eca5751
df57a6d
eca5751
 
 
 
 
df57a6d
eca5751
df57a6d
 
eca5751
df57a6d
eca5751
df57a6d
eca5751
df57a6d
 
eca5751
df57a6d
 
 
eca5751
df57a6d
 
 
 
 
 
eca5751
 
df57a6d
eca5751
 
df57a6d
eca5751
 
df57a6d
eca5751
df57a6d
 
 
 
 
 
eca5751
df57a6d
eca5751
df57a6d
eca5751
df57a6d
 
eca5751
df57a6d
eca5751
 
 
df57a6d
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
---
license: apache-2.0
base_model: Qwen/Qwen2.5-Coder-1.5B-Instruct
tags:
  - qwen2
  - coder
  - code
  - agent
  - transformers
  - text-generation
pipeline_tag: text-generation
library_name: transformers
---

<div align="center">

# 🧠 Nexus Coder

### AI Code & Security Engine β€” Qwen2.5-Coder based

**A deployable coding model: Qwen2.5-Coder-1.5B weights + Nexus Coder agent engine (skills & tools)**

</div>

## πŸ“– Introduction

**Nexus Coder** is a working AI model combining:

- **Model weights:** [Qwen2.5-Coder-1.5B-Instruct](https://huggingface.co/Qwen/Qwen2.5-Coder-1.5B-Instruct) (Apache 2.0) β€” a strong 1.5B coding model.
- **Agent engine:** the Nexus Coder framework (`nexus/`) β€” 60+ skills and 80+ tools with automatic registration, agent planner/router/memory/safety, data pipeline, and training utilities.

## πŸš€ Quick Usage

The model is a standard `Qwen2ForCausalLM`. Load it with `transformers`:

```python
from transformers import AutoModelForCausalLM, AutoTokenizer

model_id = "AdminReal/NexusCoder"
tokenizer = AutoTokenizer.from_pretrained(model_id)
model = AutoModelForCausalLM.from_pretrained(model_id)

messages = [{"role": "system", "content": "You are Nexus Coder, a helpful coding assistant."},
            {"role": "user", "content": "Write a Python function to compute fibonacci."}]
text = tokenizer.apply_chat_template(messages, tokenize=False, add_generation_prompt=True)
inputs = tokenizer([text], return_tensors="pt")
out = model.generate(**inputs, max_new_tokens=512)
print(tokenizer.decode(out[0][inputs["input_ids"].shape[1]:], skip_special_tokens=True))
```

CLI chat demo (from source):

```bash
python scripts/chat.py --model AdminReal/NexusCoder
```

## πŸ“ Repository Contents

| Part | What it is | License |
|------|-----------|---------|
| `model.safetensors`, `config.json`, `tokenizer.*` | Qwen2.5-Coder-1.5B-Instruct weights | Apache 2.0 |
| `nexus/` | Agent engine source (skills, tools, agent, data, optim) | NAL-1.0 |
| `configs/` | Experimental architecture designs (`tiny` β†’ `423b`) β€” **not** the hosted model | NAL-1.0 |
| `docs/`, `scripts/`, `tests/` | Documentation, CLI scripts, tests | NAL-1.0 |

> The `configs/nexus_coder_*.yaml` files describe a from-scratch MoE research architecture and are **independent** from the Qwen2-based weights hosted in this repo.

## βš–οΈ Licenses

- **Model weights:** Apache 2.0 (from Qwen/Qwen2.5-Coder-1.5B-Instruct). See `LICENSE`.
- **Source code (nexus engine):** NexusCoder Attribution License v1.0 (NAL-1.0). Attribution required to Hieu Louis (github.com/mhieuhonda).

## πŸ‘€ Author

Hieu Louis Β· 2026

- GitHub: @mhieuhonda
- Project: NexusCoder