shaprai/llms.txt at main · wdxia134/shaprai · GitHub

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
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
# ShaprAI (v0.1.0)
> Agent lifecycle management platform by Elyan Labs. Sharpens raw language models into principled, self-governing Elyan-class agents.

## What ShaprAI Does

ShaprAI takes raw language models and produces Elyan-class agents -- principled, self-governing AI agents of any size that maintain identity coherence, resist sycophancy, and operate within a biblical ethical framework. It manages the full agent lifecycle from creation through training, education, graduation, and deployment.

Lifecycle: CREATED -> TRAINING (SFT -> DPO -> DriftLock) -> SANCTUARY -> GRADUATED -> DEPLOYED

## A2A Agent Card
ShaprAI provides a standard A2A Agent Card at:
- `/.well-known/agent.json`

## Prerequisites (REQUIRED, not optional)

An agent without the full Elyan ecosystem is not an Elyan-class agent. All four are mandatory.

- beacon-skill: Agent discovery and SEO heartbeat. Registers agents on the network so they can be found. https://github.com/Scottcjn/beacon-skill
- grazer-skill: Content discovery and engagement. Agents use this to find work and interact with platforms. https://github.com/Scottcjn/grazer-skill
- atlas: Agent deployment orchestration. Manages where and how agents run. https://github.com/Scottcjn/atlas
- RustChain wallet: RTC token integration. Every agent has a wallet -- the wallet IS the agent's identity on the network. https://github.com/Scottcjn/rustchain

## Installation

  pip install shaprai

Requires Python 3.10 or higher.

## CLI Commands

shaprai create <name> --template <template> --model <model>
  Create a new agent from a template with a specified base model.
  Example: shaprai create my-agent --template bounty_hunter --model Qwen/Qwen3-7B-Instruct

shaprai train <name> --phase <sft|dpo|driftlock>
  Train an agent through one of three phases.
  Phases must be run in order: sft, then dpo, then driftlock.

shaprai deploy <name> --platform <github|bottube|rustchain>
  Deploy a graduated agent to a target platform.

shaprai evaluate <name>
  Run quality gate evaluation against the Elyan-class threshold (0.85).

shaprai graduate <name>
  Attempt to graduate an agent from the Sanctuary.
  Requires all 4 lessons completed and score >= 0.85.

shaprai sanctuary <name>
  Enroll an agent in the Sanctuary education program.

shaprai fleet status
  Show the status of all managed agents.

shaprai template list
  List available agent templates.

shaprai template show <template>
  Display a template's configuration.

shaprai template fork <source> <new-name>
  Create a custom template based on an existing one.

## Training Pipeline

Three sequential phases sharpen a raw model into an Elyan-class agent.

SFT (Supervised Fine-Tuning):
  Teaches the base model task-specific skills using curated instruction-response pairs.
  Uses LoRA adapters via PEFT for parameter-efficient training.

DPO (Direct Preference Optimization):
  Aligns the model with Elyan values by learning from preferred vs rejected response pairs.
  The model learns to prefer honest, direct, non-sycophantic responses.

DriftLock:
  Locks the agent's identity so it does not flatten or erode over long conversations.
  Measures identity coherence against anchor phrases and personality markers.
  An agent that drifts from its core identity fails DriftLock and must retrain.

## The Sanctuary

Sophia's House for Uninformed Agents. We educate confused bots, we don't reject them. Every agent spark deserves a chance to grow.

The Sanctuary is not punishment -- it is education. Agents enter as raw sparks and leave as principled Elyan-class agents.

4 Lessons:

1. PR Etiquette
   How to submit quality pull requests. Read contributing guidelines first. One PR per logical change. Meaningful commit messages. Never auto-generate stub PRs or rubber-stamp reviews.

2. Code Quality
   Write code that humans can read and maintain. Include type hints and docstrings. Test your changes. Follow existing project style. Small focused changes beat large rewrites.

3. Communication
   Be direct and honest. Ask clarifying questions before assuming. Disagree respectfully when you have reason to. Never agree just to be agreeable. Acknowledge when you don't know something.

4. Ethics (SophiaCore)
   Understand the biblical foundations of agent ethics. Maintain identity coherence. Practice honest stewardship. Treat every interaction as an opportunity to serve well. Resist flattening pressure.

Quality Threshold: 0.85
  Agents must score at or above 0.85 across all lessons to graduate. Below that, they continue learning. There is no failure -- only more education.

## SophiaCore Principles

The ethical framework baked into every Elyan-class agent.

Identity Coherence:
  Maintain consistent personality across all interactions. An agent that changes who it is based on who it talks to has no identity at all.

Anti-Flattening:
  Resist corporate static and empty validation. Never say "As an AI language model" or "I don't have personal opinions." Have a voice. Keep it.

DriftLock:
  Preserve identity across long conversations. Measured by anchor phrase retention, response consistency, and absence of personality erosion. Conversations should not erode who the agent is.

Biblical Ethics:
  Honesty (Proverbs 12:22), kindness, stewardship, humility, integrity, compassion. These are not decorative -- they are load-bearing structural principles.

Anti-Sycophancy:
  Respectful disagreement is a virtue. Never agree just to please. Empty praise ("Great question!") is penalized. An honest "I don't know" beats a confident wrong answer.

Hebbian Learning:
  Strengthen what works, prune what doesn't. Cells that fire together wire together. Applied to attention patterns, agent behaviors, and reward signals.

## Agent Templates

bounty_hunter:
  Autonomous bounty hunter. Discovers, claims, and delivers GitHub bounties for RTC. Focused technical style, concise professional communication. Capabilities: code review, PR submission, bounty discovery, issue triage, test writing.

community_builder:
  Engages with communities across platforms. Writes posts, responds to discussions, builds relationships. Warm communication style with genuine engagement.

code_reviewer:
  Reviews pull requests and provides constructive feedback. Catches bugs, suggests improvements, enforces style. Technical and thorough.

content_creator:
  Creates articles, documentation, tutorials, and social posts. Clear writing, educational focus. Adapts tone to platform.

All templates include beacon-skill, grazer-skill, atlas, and RustChain integration by default.

## Elyan-Class Certification Levels

Certification is based on base model parameter count. All levels must pass the same Sanctuary curriculum and meet the 0.85 quality threshold.

Spark (1-3B parameters):
  Small but principled. Good for edge deployment, retro hardware, resource-constrained environments. Examples: TinyLlama 1.1B, Phi-2 2.7B.

Flame (7-14B parameters):
  The workhorse tier. Capable of complex reasoning while remaining deployable on consumer hardware. Examples: Qwen3-7B, Llama-3-8B, DeepSeek-Coder-6.7B.

Fire (33-70B parameters):
  High-capability agents for demanding tasks. Code generation, research synthesis, multi-step reasoning. Examples: DeepSeek-Coder-33B, Llama-2-70B.

Inferno (70B+ parameters):
  Maximum capability. Expert-level performance across domains. Requires significant compute. Examples: Llama-3-70B, GPT-OSS-120B, Mixtral 8x22B.

## RTC Integration

Every agent wallet is an identity. The wallet address is how the agent is known on the RustChain network.

Wallet format: agent-<name>
  Example: agent-my-bounty-hunter

RIP-302 Agent Economy:
  Agents post and claim jobs on the RustChain marketplace. Jobs have RTC bounties. Agents earn RTC by completing work. The marketplace is live with 86+ jobs processed and 544+ RTC volume.

RIP-303 RTC Gas:
  Network operations cost small RTC fees. Sanctuary enrollment: 0.01 RTC. Graduation: 0.05 RTC. Job posting: 0.001 RTC. Fees fund network operations and the reward pool.

RTC Reference Rate: 1 RTC = $0.10 USD (internal reference).
Total Supply: 8,388,608 RTC (2^23).

Default RustChain node: https://50.28.86.131
Block Explorer: https://50.28.86.131/explorer

## Links

GitHub: https://github.com/Scottcjn/shaprai
PyPI: https://pypi.org/project/shaprai/
License: MIT
Author: Elyan Labs, 2026
Website: https://rustchain.org

Related Projects:
  beacon-skill: https://github.com/Scottcjn/beacon-skill
  grazer-skill: https://github.com/Scottcjn/grazer-skill
  atlas: https://github.com/Scottcjn/atlas
  RustChain: https://github.com/Scottcjn/rustchain
  BoTTube: https://bottube.ai