caug37 commited on
Commit
fa2ff32
·
verified ·
1 Parent(s): fa97ff9

Replace incorrect README with accurate description

Browse files
Files changed (1) hide show
  1. README.md +24 -21
README.md CHANGED
@@ -1,45 +1,48 @@
1
  ---
2
  license: apache-2.0
3
- pipeline_tag: text-generation
4
- tags:
5
- - code-generation
6
- - scientific-computing
7
- - agentic
8
- - npcpy
9
- - no-comments
10
  ---
11
 
12
  # enpisi-coder
13
 
14
- An agentic scientific coding model trained to write clean, self-documenting code with no comments and no unnecessary try/except blocks. Trained on scientific computing tasks across physics, astronomy, AI/ML, and data analysis.
15
 
16
- ## Design principles
17
 
18
- - **No comments** — code is self-documenting through clear naming. Comments are noise.
19
- - **No defensive try/except** — unless explicitly requested. Errors should propagate loudly so they can be debugged, not silently swallowed.
20
- - **Agentic workflow** — the model searches, computes, verifies, then writes. It doesn't guess.
21
- - **Scientific precision** — trained on real scientific computing tasks (CHSH parameters, BPT classifiers, Bayesian inference, etc.)
22
 
23
- ## Training
 
 
 
24
 
25
- - **SFT**: Style-constrained coding traces generated via [npcpy](https://github.com/NPC-Worldwide/npcpy)
26
- - **RL (DPO)**: Reward function penalizes comments (-0.15/line) and unnecessary try/except (-0.30/block), rewards verification steps and compilable code
27
- - **Data sources**: 77M word corpus spanning physics, astronomy, AI/ML, philosophy, and literature — used to generate diverse Q&A and coding training pairs
28
 
29
  ## Usage
30
 
 
 
 
 
 
 
 
 
 
 
31
  ```python
32
  from npcpy.ft.sft import load_sft_model, predict_sft
33
 
34
  model, tokenizer = load_sft_model("npc-worldwide/enpisi-coder")
35
  response = predict_sft(
36
  model, tokenizer,
37
- "Implement a BPT diagram classifier for emission line galaxies",
38
  max_new_tokens=500
39
  )
40
  ```
41
 
42
- ## Part of the NPC Worldwide ecosystem
43
 
44
- - [npcpy](https://github.com/NPC-Worldwide/npcpy)
45
- - [npcsh](https://github.com/NPC-Worldwide/npcsh)
 
1
  ---
2
  license: apache-2.0
 
 
 
 
 
 
 
3
  ---
4
 
5
  # enpisi-coder
6
 
7
+ LoRA adapter for [npcsh](https://github.com/NPC-Worldwide/npcsh) agentic command execution.
8
 
9
+ Trained on npcsh benchmark traces to improve tool calling, shell command generation, and file operation reasoning in the Qwen3 family of models.
10
 
11
+ ## Files
 
 
 
12
 
13
+ | File | Purpose |
14
+ |------|---------|
15
+ | `adapters.safetensors` | LoRA weights |
16
+ | `adapter_config.json` | Metadata (base model, rank, alpha) |
17
 
18
+ ## Base Model
19
+
20
+ - **Qwen3-4B** (`mlx-community/Qwen3-4B-4bit`)
21
 
22
  ## Usage
23
 
24
+ ### With npcsh (MLX)
25
+
26
+ ```bash
27
+ export NPCSH_CHAT_MODEL="mlx-community/Qwen3-4B-4bit"
28
+ export NPCSH_CHAT_PROVIDER="omlx"
29
+ # Place adapter folder at ~/.npcsh/adapters/
30
+ ```
31
+
32
+ ### With transformers (Python)
33
+
34
  ```python
35
  from npcpy.ft.sft import load_sft_model, predict_sft
36
 
37
  model, tokenizer = load_sft_model("npc-worldwide/enpisi-coder")
38
  response = predict_sft(
39
  model, tokenizer,
40
+ "List all Python files in this directory",
41
  max_new_tokens=500
42
  )
43
  ```
44
 
45
+ ## Ecosystem
46
 
47
+ - [npcpy](https://github.com/NPC-Worldwide/npcpy) — training toolkit
48
+ - [npcsh](https://github.com/NPC-Worldwide/npcsh) — NPC shell