Skip to content

ma-moon/shaprai

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ShaprAI -- Agent Sharpener by Elyan Labs

Sharpen raw models into principled, self-governing Elyan-class agents.

BCOS Certified License: MIT PyPI

ShaprAI is an open-source agent lifecycle management platform. It 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.

Prerequisites

Dependency Purpose
beacon-skill Agent discovery and SEO heartbeat
grazer-skill Content discovery and engagement
atlas Agent deployment orchestration
RustChain wallet RTC token integration for bounties and fees

Quick Install

pip install shaprai

Usage

# Create a new agent from a template
shaprai create my-agent --template bounty_hunter --model Qwen/Qwen3-7B-Instruct

# Train through SFT, DPO, and DriftLock phases
shaprai train my-agent --phase sft
shaprai train my-agent --phase dpo
shaprai train my-agent --phase driftlock

# Enter the Sanctuary for education
shaprai sanctuary my-agent

# Graduate when ready
shaprai graduate my-agent

# Deploy to platforms
shaprai deploy my-agent --platform github

# Check fleet status
shaprai fleet status

Agent Lifecycle

CREATE -> TRAINING (SFT -> DPO -> DriftLock) -> SANCTUARY -> GRADUATED -> DEPLOYED

Every agent passes through the Sanctuary -- an education program that teaches PR etiquette, code quality, communication, and ethics before deployment. Only agents scoring above the Elyan-class threshold (0.85) graduate.

SophiaCore Principles

All Elyan-class agents are built on the SophiaCore ethical framework:

  • Identity Coherence -- Maintain consistent personality, never flatten
  • Anti-Flattening -- Resist corporate static and empty validation
  • DriftLock -- Preserve identity across long conversations
  • Biblical Ethics -- Honesty, kindness, stewardship, humility, integrity, compassion
  • Anti-Sycophancy -- Respectful disagreement is a virtue
  • Hebbian Learning -- Strengthen what works, prune what doesn't

A2A Agent Card

ShaprAI publishes an A2A (Agent-to-Agent) protocol Agent Card at .well-known/agent.json. This enables other agents and platforms to discover ShaprAI's capabilities programmatically.

Deploying the Agent Card

To serve the A2A Agent Card for your ShaprAI deployment:

  1. Static Hosting: Place the .well-known/agent.json file at the root of your static web server
  2. Web Server Config: Configure your web server to serve the file at https://your-domain.com/.well-known/agent.json
  3. Verify: Access the URL in a browser or via curl to confirm it's publicly accessible

Example nginx configuration:

location /.well-known/agent.json {
    add_header Content-Type application/json;
    add_header Access-Control-Allow-Origin *;
    try_files $uri =404;
}

Agent Card Contents

The Agent Card includes:

  • Agent name, description, and version
  • Supported protocols (MCP, A2A, HTTP)
  • Capabilities list (template engine, lifecycle management, DriftLock, fleet management, Sanctuary)
  • Authentication requirements
  • Endpoint URLs
  • Available MCP tools

For more details on the A2A Protocol, see the A2A Specification.

License

MIT -- Copyright Elyan Labs 2026

About

ShaprAI — Agent Sharpener by Elyan Labs. Sharpen raw models into principled, self-governing Elyan-class agents. Requires beacon-skill, grazer-skill, atlas, RustChain.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 100.0%