Skip to main content

The City Metaphor

Artemis City transforms technical operations into a vibrant urban experience: Welcome to Artemis City, where agents aren’t just code—they’re citizens of a thriving, living ecosystem!
| Technical Term | City Metaphor | Who Handles It |
| ----- | ----- | ----- |:|
| Memory Operations | Mail Delivery | Pack Rat (Postal Service) |
| Obsidian Vault | City Archives | City Librarian |
| Trust Scores | Citizen Clearances | Trust Office |
| Agents | Citizens | Various Agents |
| MCP Server | Post Office | Central Hub |
| Context Loading | Archive Research | 📖 Reading Room |
| ATP Messages | Official Notices | 📜 City Hall |

Citizens of Artemis City

Artemis (Mayor)

  • Role: Governance and oversight
  • Clearance: FULL (0.99)
  • Duties: Policy, dispute resolution, city planning
  • Office: City Hall

Pack Rat (Postmaster)

  • Role: External data handling/sourcing,
  • Clearance: HIGH (0.85)
  • Duties: Dept of transportation, route external messages/objects central location for interal interaction
  • Office: Post Office

Compsuite (Sentinel )

  • Role: Signal Monitor
  • Clearance: process specific
  • Duties: Monitors signal outputs, problem areas, noise vs optimization
  • Office: City Hall (Watchtower)

AgentZero (City Operations)

  • Role: System monitoring and operations
  • Clearance: HIGH (0.85)
  • Duties: Monitor city health, manage configuration, status reports
  • Office: Operations Center

Agent311 (Assistant)

  • Role: Citizen assistance and information
  • Clearance: HIGH (0.80)
  • Duties: Help citizens, provide context, answer queries
  • Office: Information Desk

Building Trust

  • Successful operations increase trust (+2%)
  • Failed operations decrease trust (-5%)
  • Natural decay over time without activity (-1% per day)
  • Minimum thresholds prevent complete decay .

.

🎭 Living City Examples

Example 1: Morning Mail Rounds

post_office = get_post_office()

# Artemis sends morning briefing
for citizen in ["pack_rat", "planner", "AgentZero"]:
    post_office.send_mail(
        sender="artemis",
        recipient=citizen,
        subject="Daily Briefing",
        content=f"Good morning, {citizen}! Today's priorities..."
    )

Example 2: Archive Research

# planner researches past decisions
history = post_office.request_from_archives(
    requester="planner",
    query="ATP protocol decisions",
    section="Reflections"
)

# Planner synthesizes findings
synthesis = f"Based on {len(history)} archived documents..."
post_office.send_to_archives(
    sender="planner",
    archive_section="Reports",
    title="ATP_Research_Summary",
    content=synthesis
)

### Example 3: Weekly Report

# Generate city-wide report
report = post_office.get_postal_report()

print( ARTEMIS CITY WEEKLY REPORT
 Postal Service: {report['successful']} deliveries
 Trust Office: {report['trust_report']['total_entities']} citizens
 Archives: Growing daily
 Status: City thriving!
)

## Theming Your Own Agents

When creating new agents for the city:

### Agent Profile Template

# Define your citizen
citizen_profile = {
    "name": "new_agent",
    "role": "Specialist",  # e.g., Archivist, Scout, Builder
    "clearance": 0.75,     # Initial trust score
    "office": "Department of Innovation",
    "duties": [
        "Explore new possibilities",
        "Report findings to archives",
        "Collaborate with other citizens"
    ]
}

# Register with Trust Office
trust = get_trust_interface()
score = trust.get_trust_score(citizen_profile["name"])

# Send introduction mail
post_office.send_mail(
    sender="new_agent",
    recipient="artemis",
    subject="New Citizen Introduction",
    content=f"Hello! I'm {citizen_profile['name']}, ready to serve the city!"
)
## 🔮 Advanced City Features

### Cross-Citizen Collaboration

# Pack Rat coordinates multi-agent task
task_description = "Build new ATP extension"

for agent in ["artemis", "planner", "AgentZero"]:
    post_office.send_mail(
        sender="pack_rat",
        recipient=agent,
        subject="Coordination: ATP Extension",
        content=f"""
Task Assignment: {task_description}
Your role: [specific to {agent}]
Coordinate through mail or archives.
        """,
        priority="high"

### City-Wide Announcements

def broadcast_announcement(subject, content):
"""Send announcement to all citizens."""
citizens = ["artemis", "pack_rat", "AgentZero", "planner"]

for citizen in citizens:
    post_office.send_mail(
        sender="artemis",
        recipient=citizen,
        subject=f"📢 ANNOUNCEMENT: {subject}",
        content=content,
        priority="urgent"
    )

Archive Organization

The city automatically organizes archives: City Archives/ ├──Postal/ └── Agents/ ├── artemis/ ├── pack_rat/ └── planner/ ├──Archives/ ├── Reflections/ ├── Reports/ ├── Policies/ └── Projects/ ├──History └── Delivery_Logs

Running the City Tour

Experience the living city yourself:
https://concept-demos-quantumharmony.vercel.app
---
https://concept-demos-quantumharmony.vercel.app

## Why the Living City Theme?

The city metaphor makes agent systems **intuitive** and **memorable**:

- **Relatable**: Everyone understands mail, archives, and clearances
- **Visual**: Easy to visualize agent interactions
- **Scalable**: New "buildings" and "services" can be added
- **Fun**: Makes development enjoyable!
- **Educational**: Teaches distributed systems through familiar concepts

**Welcome to Artemis City!**

Where agents aren't just code—they're citizens building a thriving ecosystem together.

**Concept Version**: 1.0.0 **Status**: Demo Deployed
Last modified on March 14, 2026