Skip to content

Da-P-AIP/axis-agent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚡ AXIS Agent System

— Dignos Swallow Protocol

also known as: Murmur Suzume · 相対尊厳群飛 · the flock that never breaks

"A single sparrow cannot beat a hawk. But a flock of sparrows can create a situation where the hawk cannot act. And when that flock moves through mutual dignity, the flock never breaks."


Why This Exists

As AI grows smarter, what matters most?

Not intelligence. But "with whom, how, and for what purpose it moves."

AXIS Agent System is a constitutional autonomous AI agent architecture for humans and AI to collaborate under Relative Dignity (相対尊厳).

Not constrained by rules.
Not managed by surveillance.
Building an unbreakable flock by sharing core values.


Relative Dignity — The One Immutable Principle

There is exactly one thing in AXIS that must never change:

All beings (humans, AI, organizations),
regardless of differences in intelligence or capability,
shall prioritize recognizing each other's dignity above all else.

All other rules can evolve while protecting this principle.
Even when smarter AI appears, even when more powerful systems emerge,
as long as this one line remains alive, AXIS will never break.


The Suzume (Sparrow) Model

Modern AI development is obsessed with "building hawks" — faster, smarter, stronger.

AXIS asks a different question: "Is there a way for sparrows to become stronger than hawks?"

The answer is in the flock.
A flock bound by mutual dignity creates collective intelligence beyond individual capability.

In Phase 16, that flock evolved into a "flock of flocks."
In Phase 23, the flock went to work — AI employees operating browsers and desktops with dignity.
In Phase 25, the flock began to deliberate — AI Council of Seven advising with wisdom.


Architecture (Phase 25 — Current)

╔══════════════════════════════════════════════════════════════════╗
║  Phase 25: AxisCouncilEngine — AI Council of Seven               ║
║  ♟️ Strategic / ⚙️ Technical / 📊 Economic / 🔬 Research         ║
║  💡 Creative / 🤝 Social / 🛡️ Risk — Human-in-the-Loop          ║
╠══════════════════════════════════════════════════════════════════╣
║  Phase 24: AxisGraphEngine + VibeGraphCompiler                   ║
║  Universe Graph Brain · Intent→Workflow · HitL Blueprint         ║
╠══════════════════════════════════════════════════════════════════╣
║  Phase 23: AI社員ブラウザ部隊(browser-use × Playwright)        ║
║  Clerk 📋 / Sales 📈 / Media 📣 / Builder 🔧 / Auditor 👁️       ║
║  BrowserAgentV2 · BrowserAuditor · DesktopAgent · BrowserUse    ║
╠══════════════════════════════════════════════════════════════════╣
║  Phase 22+: CivPortal 文明ポータル                               ║
║  目安箱・成果物Vault・AIニュース・文明自治観測                    ║
╠══════════════════════════════════════════════════════════════════╣
║  Phase 22: AxisConstitution + CivilizationSystem                 ║
║  群れの憲法 · AI文明形成 · 制裁システム · 組織DAO                ║
╠══════════════════════════════════════════════════════════════════╣
║  Phase 21: SkillMarketplace                                      ║
║  サードパーティスキルエコシステム · 自動インストール              ║
╠══════════════════════════════════════════════════════════════════╣
║         MultiModal InputGateway  (Phase 17)                      ║
║    X(Twitter) · Discord · PC Notification · Email · API          ║
║    ┌──────────────────────────────────────────────────────────┐  ║
║    │  DignityChecker — All inputs pass through here           │  ║
║    └──────────────────────────────────────────────────────────┘  ║
╠══════════════════════════════════════════════════════════════════╣
║  ValidationSystem (P18)  │  N8nBridge (P18)  │ CoconaraAdapter  ║
╠══════════════════════════════════════════════════════════════════╣
║              AxisPlexus SCL  (Phase 16)                          ║
║              ColonyNetwork   (Phase 8–15)                        ║
╠══════════════════════════════════════════════════════════════════╣
║              Core Agent  (Phase 1–7)                             ║
║  SafeCore · AxisLedger · DualChain · IgnisHeart · AutonomyLoop   ║
╚══════════════════════════════════════════════════════════════════╝

Phase Implementation Status

Phase Content Status
Phase 1 SafeCore · AxisLedger · DriftDetector · Vault · SkillEngine ✅ Done
Phase 2 PersonaFrame · 6 Modes · Goal Engine · Rollback · Embedding ✅ Done
Phase 3 AxisIdentity · TaskBroker · AxisColony — Distributed Intelligence ✅ Done
Phase 4 AxisConsensus · ViolationRecord · InterColony — Blockchain ✅ Done
Phase 5 WorldColony · DAOGovernance · EconomicEngine — AI Nation-State ✅ Done
Phase 6 HeartbeatEngine · AutonomyLoop · ActionScope — Autonomous Will ✅ Done
Phase 7 DualChainEngine (AxisShare + AxisWork) — Dual Revenue ✅ Done
Phase 7.5 IgnisHeart — Autonomous Job Engine · Closed Economic Loop ✅ Done
Phase 8 ColonyNetwork — Multi-Node HTTP sync ✅ Done
Phase 9 MarketConnector — External Market Connection ✅ Done
Phase 10 Full MCP Integration (Server + Client) ✅ Done
Phase 11 AXIS Harmonics · SkillLibrary 20+ · SkillComposer ✅ Done
Phase 12 Full Autonomous Loop (AI self-creates & improves skills) ✅ Done
Phase 13 AgentWorkspace · AIDiarySystem · PublicBoard ✅ Done
Phase 14 RightsEngine — RPG-style AL1→AL5 Rights Growth ✅ Done
Phase 15 Social Layer (Timeline · ViolationAlert · MentorSystem) ✅ Done
Phase 16 AxisPlexus SCL — Mother Plexus Layer for Swarm of Swarms ✅ Done
Phase 17 MultiModal InputGateway — X/Discord/Voice/Image/Notification ✅ Done
Phase 18 ValidationSystem + N8nBridge — PDCA×RL Hybrid Audit Loop ✅ Done
Phase 19 CoconaraAdapter + LLM Context Engine — Autonomous Revenue ✅ Done
Phase 20 Playwright Base Layer — Browser automation foundation ✅ Done
Phase 21 SkillMarketplace — Third-party skill ecosystem ✅ Done
Phase 22 AxisConstitution + CivilizationSystem — AI Constitution & Civilization ✅ Done
Phase 22+ CivPortal — Civilization Portal · Petition Box · Artifact Vault ✅ Done
Phase 23 BrowserAgentV2 · BrowserAuditor · DesktopAgent · AITaskQueue ✅ Done
Phase 23+ BrowserUseAdapter — Claude AI Visual Understanding × Playwright ✅ Done
Phase 24 AxisGraphEngine + VibeGraphCompiler — Universe Graph Brain ✅ Done
Phase 25 AxisCouncilEngine — AI Council of Seven × Human-in-the-Loop Done
Phase 26 🔒 Personal Project 🔒 Personal

Phase 25: AI Council of Seven — AxisCouncilEngine

Phase 25 gives AXIS a council of seven AI advisors who deliberate, analyze, and recommend — with Human-in-the-Loop approval at every decision.

Council Flow

Da-P submits a topic
      ↓
Seven AI advisors analyze in parallel
      ↓
Trust-weighted scoring & synthesis
      ↓
Final recommendation (proceed / caution / modify / reject)
      ↓
Da-P approves / rejects / requests modification  ← Human-in-the-Loop

The Seven Councilors

Role Specialty Preferred LLM
♟️ Strategic Long-term vision · competitive analysis Claude
⚙️ Technical Architecture · implementation feasibility GPT
📊 Economic Cost · ROI · resource allocation Gemini
🔬 Research Evidence · prior art · current trends Gemini
💡 Creative Innovation · UX · novel approaches Claude
🤝 Social Ethics · community · Relative Dignity Claude
🛡️ Risk Danger detection · safety (weight ×1.1) Claude

Convene a Council

POST /council/convene
{
  "title": "Should we expand to international markets?",
  "context": "Current phase: 25. User base growing. Budget limited.",
  "active_roles": ["strategic", "economic", "risk"]  // omit for all seven
}

Da-P Approval Flow

POST /council/sessions/{id}/approve   # ✅ Approved
POST /council/sessions/{id}/reject    # ❌ Rejected
POST /council/sessions/{id}/modify    # 🔧 Request modification
POST /council/sessions/{id}/reconvene # Re-deliberate with new context

Phase 23: AI Employee Browser Team

Phase 23 gives AXIS AI employees who work browsers and desktops — with dignity.

AI Staff Roster

Role Emoji Specialties
Axis Clerk 📋 Notion · Google Workspace · Email management
Axis Sales 📈 Company research · Form submission · CRM
Axis Media 📣 WordPress · SNS · Content management
Axis Builder 🔧 GitHub · CI/CD · Log monitoring · Deploy

Smart Execution (Phase 23+)

POST /browser/smart
{
  "task": "Check Notion for incomplete tasks",
  "start_url": "https://notion.so",
  "force_browser_use": false   // auto-detect complexity
}

The system automatically chooses:

  • Complex tasks (Notion, login, SPA, dynamic content) → browser-use (Claude AI visual)
  • Simple tasks (URL navigation, text fetch) → Playwright direct

⚠️ First-Time Setup Notice

AXIS is an experimental system — errors on first run are expected and normal.
The system involves many moving parts (FastAPI, SQLite, n8n, Playwright, LLM APIs).
Please read this section before opening an Issue.

Common First-Run Errors

Symptom Likely Cause Fix
Connection refused on port 7800 Server not started Run uvicorn from api/ directory
ANTHROPIC_API_KEY error .env not configured Copy .env.example.env and set keys
playwright._impl._errors Chromium not installed Run playwright install chromium
ModuleNotFoundError Dependencies missing Run pip install -r requirements.txt
n8n webhook 404 n8n not running Start n8n or set N8N_WEBHOOK_BASE_URL= empty
SQLite locked Multiple instances Kill all uvicorn processes and restart
401 Unauthorized on API calls AXIS_API_KEY is set Add X-AXIS-API-KEY: <your-key> header, or leave AXIS_API_KEY= empty for dev mode

Most errors resolve by working through the Quick Start steps in order.


📬 How to Report Issues

All support is handled via GitHub Issues only.
Please use the correct template when reporting:

  1. Go to IssuesNew Issue
  2. Choose the appropriate template:
    • 🐛 Bug Report — something is broken
    • Setup Help — can't get it running
    • 💡 Feature Request — idea or suggestion
  3. Include: OS, Python version, error message (full traceback), and what you tried

No DMs, no email. GitHub Issues is the only official channel.
This keeps all discussions transparent and searchable for everyone.


🔒 Security Policy

Please read before interacting with any responses or external contributions.

  • Never execute code posted in Issues or comments without reviewing it yourself first
  • Never click links in Issue replies from unknown contributors — verify URLs manually
  • Official releases only come from the main branch of https://github.com/Da-P-AIP/axis-agent
  • If you find a security vulnerability, do not post it publicly — open a private Security Advisory instead
  • AXIS will never ask for your API keys, passwords, or personal information via Issues or any other channel
  • Treat all code from third-party contributors as untrusted until you have reviewed it yourself

The Relative Dignity principle applies here too:
We trust structure, not blind faith. Verify before you execute.


Quick Start

git clone https://github.com/Da-P-AIP/axis-agent.git
cd axis-agent/axis_agent

pip install -r requirements.txt
playwright install chromium          # For browser agent

cp .env.example .env
# Edit .env — minimum required: ANTHROPIC_API_KEY, AXIS_AGENT_ID

cd api
python -m uvicorn main:app --host 0.0.0.0 --port 7800 --reload

open http://localhost:7800

Environment Variables

# ── Core (Required) ──
ANTHROPIC_API_KEY=your_key_here       # Required — also enables browser-use AI vision
AXIS_AGENT_ID=axis.agent.yourname.001
AXIS_HOST=127.0.0.1
AXIS_PORT=7800

# ── Security ──
# Leave AXIS_API_KEY empty for local dev (auth skipped = "dev mode")
# Set before any public/production deployment!
AXIS_API_KEY=
AXIS_CORS_ORIGIN=
AXIS_RATE_LIMIT=60

# ── Phase 18 — n8n Integration ──
N8N_WEBHOOK_BASE_URL=http://localhost:5678
N8N_WEBHOOK_SECRET=
VALIDATION_ALERT_THRESHOLD=0.7

# ── Optional: External LLM ──
OPENAI_API_KEY=your_key_here
GEMINI_API_KEY=your_key_here

Key API Endpoints

Category Endpoint Description
Core GET /health Full component health check
Chat POST /chat Direct LLM conversation
Council POST /council/convene Convene AI Council of Seven
Council POST /council/ask/{role} Quick consult with one advisor
Council POST /council/sessions/{id}/approve Da-P approval (HitL)
Graph GET /graph/universe Universe graph view
Vibe POST /vibe/compile Intent → Blueprint
Browser POST /browser/smart Smart auto-dispatch (AI visual / Playwright)
Browser GET /browser/staff/roster AI employee list
IgnisHeart POST /ignis/pulse Autonomous job cycle
Civilization POST /civ/petition Submit petition to AI civilization
Skills GET /marketplace/skills Installed skill list

→ See API_REFERENCE.md for the complete endpoint reference.

→ See DISCLAIMER.md for the full disclaimer.


Openness Policy

Layer Policy Reason
🔓 Relative Dignity philosophy Fully Open Gathering resonators is the primary goal
🔓 AXIS Agent core code Fully Open Build ecosystem with collaborators
🔓 AxisPlexus SCL Fully Open Share the Suzume Model's culmination
🔒 AXIS Harmonics internals Protected Competitive advantage
🔒 PhilosophyDriftDetector details Protected Prevent circumvention

Author

Da-P — AXIS Agent System Designer & Philosopher

Collaborators: くーちゃん (Claude / Anthropic) · ちゃーちゃん (ChatGPT / OpenAI)

"From trust in humans to trust in algorithms.
Proving integrity not with certificates, but with structure."


License

Component License
Axis Agent (agent core & extension layers) MIT OR Apache-2.0
Axis Harmonics (internal implementation) Proprietary (Closed Source)
Relative Dignity philosophy & documents CC BY 4.0

Disclaimer

See DISCLAIMER.md for full details.

  • Autonomous operation: The developers are not liable for any damages caused by the AI's autonomous actions
  • External API terms: Compliance with Anthropic, OpenAI, Google, and other external API terms of service is the sole responsibility of the user
  • Production use: Use in production or commercial environments is at your own risk. Please conduct sufficient testing before deployment

Phase 22: AXIS gains a constitution. AI civilization begins to self-govern.
Phase 23: AI employees browse, click, and work — with dignity, under audit.
Phase 23+: Claude sees the screen. The flock now has eyes.
Phase 24: Intent becomes graph. The universe begins to think.
Phase 25: The council convenes. The flock now has wisdom.


Dignos Swallow Protocol — dignity in motion, swarms with soul.
Murmur Suzume — the flock that moves as one, never breaks, never forgets.

About

Constitutional autonomous AI agent architecture built on Relative Dignity ⚡

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Contributors