Partenon — Developers

AGENT SPECIFICATIONS

HERO TECHNICAL PROFILES

Each profile exposes live tools, credential-gated integrations, and roadmap items — with the real install steps and API endpoints below.

book

THE SCRIBE

Hermes profile — finance

Financial records profile. Parses and classifies finance data, builds local dashboards and .finance files, and writes to Google Sheets when connected.

Capability	Tool	Status
Parse & classify finance data	local parser	live
Build local dashboards	.finance / local	live
Write to Google Sheets	Google Workspace API	connect
Google Drive operations	Google Drive API	roadmap

Implemented tools

Local file parsing
.finance files
Local dashboard builder
Google Sheets writes (with credentials)

$ python3 scripts/demo_scribe.py

Credentials & roadmap

GOOGLE_SERVICE_ACCOUNT_JSON or OAuth client for Workspace writes.
Roadmap: Google Drive operations.

info Status

Live Connect Roadmap

Live tools run locally. Connect credentials to unlock integrations. Roadmap items are not yet implemented.

WORKS CLOSELY WITH

The Herald

The Collector

The Brain

MCP CONNECTIONS Google Workspace integration (connect)

chat

THE HERALD

Hermes profile — brand / comms

Brand and communications profile. Drafts copy, builds content calendars and presentation outlines, and creates Google Docs and Slides when connected.

Capability	Tool	Status
Copy drafts	.design / local	live
Content calendar	local calendar	live
Google Docs / Slides	Google Workspace API	connect
Social publishing	Instagram, Twitter, LinkedIn, Mailchimp	roadmap

Implemented tools

Brand copy drafts
.design files
Content calendars
Presentation outlines

$ python3 scripts/demo_scribe.py

Credentials & roadmap

Google Workspace credentials for Docs/Slides creation.
Roadmap: Instagram, Twitter, LinkedIn, Mailchimp publishing.

info Status

Live Connect Roadmap

Live tools run locally. Connect credentials to unlock integrations. Roadmap items are not yet implemented.

WORKS CLOSELY WITH

The Scribe

The Diplomat

The Brain

MCP CONNECTIONS Google Workspace / Docs (connect); Social APIs (roadmap)

credit_card

THE COLLECTOR

Hermes profile — payments

Payments profile. Runs dry-run invoices, subscriptions, and revenue reports, and creates Stripe payment links. Live charges require a Stripe secret key.

Capability	Tool	Status
Dry-run invoices	payments MCP	live
Subscription schedules	payments MCP	live
Revenue reports	Stripe API	connect
Stripe Connect	Stripe Connect	roadmap

Implemented tools

Dry-run invoices
Subscription schedules
Revenue reports
Payment links

$ python3 scripts/demo_scribe.py

Credentials & roadmap

STRIPE_SECRET_KEY for live charges and revenue data.
Roadmap: Stripe Connect.

info Status

Live Connect Roadmap

Live tools run locally. Connect credentials to unlock integrations. Roadmap items are not yet implemented.

WORKS CLOSELY WITH

The Scribe

The Strategist

The Brain

MCP CONNECTIONS Stripe integration (connect)

shield

THE GUARDIAN

Hermes profile — security

Security and policy profile. Audits key strength, detects providers, and logs policy checks. NVIDIA GPU allocation is roadmap.

Capability	Tool	Status
Key-strength audit	security MCP	live
Provider detection	security MCP	live
Policy logging	security MCP	live
NVIDIA GPU allocation	NVIDIA API	roadmap

Implemented tools

Key-strength audit
Provider detection
Policy logging

$ python3 scripts/demo_scribe.py

Credentials & roadmap

Optional secrets manager for credential rotation.
Roadmap: NVIDIA GPU allocation / NemoClaw integration.

info Status

Live Connect Roadmap

Live tools run locally. Connect credentials to unlock integrations. Roadmap items are not yet implemented.

WORKS CLOSELY WITH

The Brain

MCP CONNECTIONS Security checks (live); NVIDIA (roadmap)

calendar_month

THE STRATEGIST

Hermes profile — operations

Operations profile. Plans projects, tasks, and checklists locally and coordinates via Google Calendar, Gmail, and Slack when connected.

Capability	Tool	Status
Project / task planning	local ops	live
Calendar events	Google Calendar API	connect
Email & Slack briefings	Gmail / Slack API	connect
Notion / Google Tasks PM	external PM APIs	roadmap

Implemented tools

Project planning
Task and checklist tracking
Local operations

$ python3 scripts/demo_scribe.py

Credentials & roadmap

Google Calendar / Gmail credentials.
SLACK_BOT_TOKEN for Slack briefings.
Roadmap: Notion, Google Tasks PM suite.

info Status

Live Connect Roadmap

Live tools run locally. Connect credentials to unlock integrations. Roadmap items are not yet implemented.

WORKS CLOSELY WITH

The Diplomat

The Collector

MCP CONNECTIONS Google Calendar, Gmail, Slack (connect); Notion / Google Tasks (roadmap)

groups

THE DIPLOMAT

Hermes profile — relations

Relationships profile. Tracks clients and vendors, drafts follow-ups, and uses Google Workspace and Gmail when connected. CRM sync is roadmap.

Capability	Tool	Status
Client / vendor tracking	relations MCP	live
Follow-up drafts	relations MCP	live
Google Workspace / Gmail	Google Workspace API	connect
HubSpot / Salesforce sync	CRM APIs	roadmap

Implemented tools

Contact tracking
Follow-up drafts
Communication log

$ python3 scripts/demo_scribe.py

Credentials & roadmap

Google Workspace / Gmail credentials.
Roadmap: HubSpot / Salesforce CRM sync.

info Status

Live Connect Roadmap

Live tools run locally. Connect credentials to unlock integrations. Roadmap items are not yet implemented.

WORKS CLOSELY WITH

The Herald

The Strategist

The Scribe

MCP CONNECTIONS Google Workspace / Gmail (connect); CRM (roadmap)

neurology

THE BRAIN

Hermes profile — memory

Shared memory profile. Stores memory pages and profiles, detects conflicts, and runs on SQLite by default or Postgres for team scale.

Capability	Tool	Status
Memory pages	memory MCP	live
Profile storage	memory MCP	live
Conflict detection	memory MCP	live
Team-scale Postgres	Postgres	connect
Cross-agent optimization	advanced memory	roadmap

Implemented tools

SQLite memory
Memory pages
Profile storage
Conflict detection

$ python3 scripts/demo_scribe.py

Credentials & roadmap

GBRAIN_DATABASE_URL for Postgres team memory.
Roadmap: advanced cross-agent optimization.

info Status

Live Connect Roadmap

Live tools run locally. Connect credentials to unlock integrations. Roadmap items are not yet implemented.

WORKS CLOSELY WITH

The Scribe

The Collector

The Strategist

MCP CONNECTIONS Memory MCP (live); Postgres (connect)

MODEL CONTEXT PROTOCOL

THE NERVOUS SYSTEM

MCP is the protocol that transforms individual agents into a collective intelligence. Here is how it works inside The Partenón.

Live MCP servers: memory, finance, payments, google_workspace, comms, security, ops, relations. Roadmap: social APIs, CRM, NVIDIA.

01Context Registration

await brain.registerContext({
  agent: 'scribe',
  type: 'financial_model',
  data: financeFile,
  access: ['herald', 'strategist', 'brain'],
  ttl: '30d'
});

02Cross-Agent Discovery

const context = await brain.discover({
  requestedBy: 'herald',
  type: 'financial_model',
  scope: 'latest'
});
// Returns: The Scribe's financial data

03Insight Generation

const insight = await brain.generateInsight({
  pattern: 'correlation',
  sources: ['scribe.revenue', 
    'herald.campaigns', 
    'collector.payments'],
  output: 'optimization_report'
});

PROTOCOL METHODS

Method	Direction	Purpose	Payload
mcp.register()	Hero → Brain	Register agent capabilities	Agent config, tools, permissions
mcp.context.share()	Hero → Brain	Share work output	Context type, data, access rules
mcp.context.request()	Hero → Brain	Request shared context	Context type, filters
mcp.observe()	Brain → Hero	Subscribe to events	Event patterns, callbacks
mcp.insight.push()	Brain → Hero	Deliver insights	Insight data, confidence, actions
mcp.tool.call()	Brain → External	Execute external tool	Tool name, parameters, auth

JSON-RPC REQUEST EXAMPLE

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "google_sheets_query",
    "arguments": {
      "spreadsheetId": "...",
      "range": "A1:D100"
    }
  }
}

INTEGRATION PATTERNS

HOW DATA FLOWS THROUGH THE PARTENÓN

bolt Example 1: Sale → Financial Update → Marketing

Customer

Stripe

Collector

Brain

Scribe

Sheets

Herald

Social

Customer arrow_forward Stripe Purchase completed

Stripe arrow_forward Collector webhook: payment.success

Collector arrow_forward Brain mcp.context.share(payment_data)

Brain arrow_forward Scribe mcp.context.request(financial_update)

Scribe arrow_forward Sheets Update revenue dashboard

Brain arrow_forward Herald mcp.insight.push(high_performing_product)

Herald arrow_forward Social Boost campaign for product

calendar_month Example 2: Meeting → Tasks → Follow-up

Calendar

Strategist

Brain

Diplomat

CRM

Calendar arrow_forward Strategist Meeting scheduled

Strategist arrow_forward Brain mcp.context.share(meeting_notes)

Brain arrow_forward Diplomat mcp.context.request(client_context)

Diplomat arrow_forward CRM Log interaction

Brain arrow_forward Strategist mcp.insight.push(follow_up_tasks)

Strategist arrow_forward Calendar Create follow-up reminders

shield Example 3: Security Alert → System Response

NVIDIA

Guardian

Brain

All Heroes

Vault

Hermes

NVIDIA arrow_forward Guardian Anomaly detected

Guardian arrow_forward Brain mcp.context.share(security_alert)

Brain arrow_forward All Heroes mcp.observe(security_status)

Guardian arrow_forward Vault Rotate affected keys

Brain arrow_forward Hermes mcp.insight.push(incident_report)

database Google Workspace File Structure

Google Drive / The Partenón /
├── 📁 enterprises/
│   └── 📁 {enterprise-name}/
│       ├── 📄 enterprise.finance      ← Scribe
│       ├── 📄 enterprise.design       ← Herald
│       ├── 📄 enterprise.revenue      ← Collector
│       ├── 📄 enterprise.security     ← Guardian
│       ├── 📄 enterprise.operations   ← Strategist
│       ├── 📄 enterprise.relations    ← Diplomat
│       ├── 📄 enterprise.brain        ← Brain
│       └── 📁 shared/
│           ├── 📁 dashboards/
│           ├── 📁 campaigns/
│           ├── 📁 reports/
│           └── 📁 meetings/
├── 📁 templates/
│   ├── 📄 default.finance
│   ├── 📄 default.design
│   └── 📄 default.operations
└── 📁 archive/

WORKSHOP PROTOCOL

THE 2-HOUR HERMES INSTALL SESSION

Setup 15min

Setup (15min)

Environment prep, dependency install

Onboarding 20min

Onboarding (20min)

Hermes init, enterprise config

Hero Config 30min

Hero Config (30min)

Enable heroes, set API keys

Integration Test 25min

Integration Test (25min)

End-to-end flow test

Q&A 15min

Q&A (15min)

Open discussion

Next Steps 15min

Next Steps (15min)

Deployment, monitoring

Setup (15min)

Onboarding (20min)

Hero Config (30min)

Integration Test (25min)

Q&A (15min)

Next Steps (15min)

0:00 2:00

Pre-Workshop Checklist

# Pre-workshop requirements
$ node --version  # >= 20.0.0
$ npm --version   # >= 10.0.0

# Required accounts (free tier acceptable)
# ✓ Google account (for Workspace integration)
# ✓ Stripe account (test mode for development)
# ✓ NVIDIA account (API key for security features)

# One-line installation
$ npx create-hermes@latest my-partenon
$ cd my-partenon
$ hermes configure --interactive

description

Workshop Slides

Complete presentation deck for facilitators. Covers Partenón concept, hero introductions, live demo script, and troubleshooting guide.

description

Participant Handbook

PDF guide for workshop attendees. Step-by-step installation instructions, hero configuration cheat sheet, and FAQ.

description

Facilitator Script

Detailed speaking notes for workshop leaders. Timing cues, talking points, and interaction prompts for each phase.

Workshop Formats

Format	Duration	Audience	Capacity	Requirements
Webinar (Virtual)	2 hours	Global entrepreneurs	500	Zoom + screen share
University Session	3 hours	Students & faculty	100	Computer lab + projector
Coworking Workshop	2.5 hours	Coworking members	30	Meeting room + WiFi
BNI Chapter Meet	2 hours	Business network	25	Conference room
Accelerator Cohort	Full day	Startup teams	20	Workshop space + mentors

GET STARTED

INSTALL THE PARTENON

Clone the repo, run the installer, and add credentials to .env when you want live mode.

# Clone the public repository
$ git clone https://github.com/cuentadeservicio377-cell/partenon.git
$ cd partenon

# Run the installer
$ ./install.sh

# Add credentials to .env when you want live mode
$ cp .env.example .env
# Edit .env with GOOGLE_SERVICE_ACCOUNT_JSON, STRIPE_SECRET_KEY, etc.

# Hermes Agent is distributed separately by Nous Research.
# Install it if you want the CLI profile experience.
# https://hermes-agent.nousresearch.com/

# Partenon profiles are copied to ~/.hermes/profiles during ./install.sh
$ hermes profile use partenon-scribe

# Run the full stack with Docker Compose
$ docker compose up --build -d

# Services include the FastAPI backend, dashboard, and G-Brain database.

REPOSITORY STRUCTURE

Current layout. The monorepo structure with packages/heroes/* is the target architecture tracked in MISSING_IMPLEMENTATION.md.

partenon/
├── 📁 web/                  # Static marketing site (HTML + Tailwind)
│   ├── index.html
│   ├── heroes.html
│   └── developers.html
├── 📁 dashboard/            # Next.js 15 admin dashboard
├── 📁 hermes/profiles/      # 7 hero profiles (SOUL.md, config.yaml, skills/)
│   ├── partenon-scribe/   # The Scribe — finance
│   ├── partenon-herald/  # The Herald — brand / comms
│   ├── partenon-collector/   # The Collector — Stripe payments
│   ├── partenon-guardian/   # The Guardian — security / NVIDIA
│   ├── partenon-strategist/  # The Strategist — operations
│   ├── partenon-diplomat/# The Diplomat — CRM / relations
│   └── partenon-brain/      # The Brain — G-Brain MCP
├── 📁 partenon_core/        # Router, onboarding, workflow engine
├── 📁 gbrain/               # G-Brain MCP server + storage
├── 📁 scripts/              # setup_hermes.py, demo_scribe.py
├── 📁 examples/             # CLI/API/MCP stubs documented on this page
├── 📁 docs/                 # Founder, developer, architecture docs
├── 📄 README.md
├── 📄 install.sh
├── 📄 docker-compose.yml
└── 📄 .env.example

ENVIRONMENT VARIABLES

Variable	Required	Description	Example
PARTENON_API_SECRET	Yes	JWT/session secret (>=32 chars)	generated by install.sh
DASHBOARD_AUTH_SECRET	Yes	Dashboard session cookie secret	generated by install.sh
DASHBOARD_APP_USERNAME	Yes	Dashboard login username	admin
DASHBOARD_APP_PASSWORD	Yes	Dashboard login password	generated by install.sh
GOOGLE_SERVICE_ACCOUNT_JSON	Live mode	Google Workspace service account	/path/to/google-service-account.json
STRIPE_SECRET_KEY	Live mode	Stripe API key	sk_test_...
SLACK_BOT_TOKEN	Live mode	Slack bot token for Strategist	xoxb-...
NVIDIA_API_KEY	Roadmap	NVIDIA platform key (roadmap features)	nvapi-...
GBRAIN_DATABASE_URL	Optional	Postgres for team memory (defaults to SQLite)	sqlite:///data/gbrain.db
OPENROUTER_API_KEY	Optional	LLM routing (OpenRouter)	sk-or-v1-...

Endpoint	Method	Description
/api/v1/integrations	GET	List integration domains and their live/dry-run mode
/api/v1/integrations/{domain}/{action}	POST	Invoke a domain action (set dry_run:false for live mode)
/api/v1/health/ready	GET	Readiness probe; checks the memory store
/api/v1/metrics	GET	Prometheus metrics (served at /metrics)
/api/v1/gateway/dry_run	POST	Parse and guard a gateway message

Command	Description	Example
./install.sh	Run the local installer	./install.sh
python3 scripts/demo_scribe.py	Verify the Scribe finance demo	python3 scripts/demo_scribe.py
uvicorn partenon_api.main:app	Start the FastAPI server	uvicorn partenon_api.main:app --reload --port 8000
pytest tests/	Run the test suite	pytest tests/
docker compose up --build -d	Run the full stack	docker compose up --build -d

THE ARCHITECTUREOF HEROES

HOW THE PARTENÓN IS BUILT

HERO TECHNICAL PROFILES

THE SCRIBE

Implemented tools

Credentials & roadmap

THE HERALD

Implemented tools

Credentials & roadmap

THE COLLECTOR

Implemented tools

Credentials & roadmap

THE GUARDIAN

Implemented tools

Credentials & roadmap

THE STRATEGIST

Implemented tools

Credentials & roadmap

THE DIPLOMAT

Implemented tools

Credentials & roadmap

THE BRAIN

Implemented tools

Credentials & roadmap

THE NERVOUS SYSTEM

PROTOCOL METHODS

JSON-RPC REQUEST EXAMPLE

HOW DATA FLOWS THROUGH THE PARTENÓN

bolt Example 1: Sale → Financial Update → Marketing

calendar_month Example 2: Meeting → Tasks → Follow-up

shield Example 3: Security Alert → System Response

database Google Workspace File Structure

THE 2-HOUR HERMES INSTALL SESSION

Pre-Workshop Checklist

Workshop Slides

Participant Handbook

Facilitator Script

Workshop Formats

INSTALL THE PARTENON

REPOSITORY STRUCTURE

ENVIRONMENT VARIABLES

HERMES COMMAND LINE INTERFACE

CLI Commands

REST API Endpoints

System Status Response

READY TO BUILD?

THE ARCHITECTURE
OF HEROES