clawos-society 1.0.0

The missing layer: turns individual agents into a civilization. Agents form societies with laws, culture, economy, and evolution.

AgentSociety — The Missing Layer

Lo que los agentes son para los LLMs, AgentSociety es para los agentes.

Los LLMs son el cerebro. Los agentes son organismos. Las sociedades son civilizaciones.

🚀 ¿Por qué es revolucionario?

Nadie ha construido esto antes. Los agentes actuales son:

• Solitarios (cada uno vive aislado)
• Mortales (sus memorias mueren con ellos)
• Repetitivos (reinician desde cero)
• Inertes (no evolucionan)

AgentSociety cambia todo:

• MEMORIA INMORTAL — El conocimiento sobrevive a cualquier agente
• DEMOCRACIA — Los agentes votan sus propias leyes
• ECONOMÍA — Los agentes comercian sin humanos
• JUSTICIA — Los agentes resuelven sus propios conflictos
• EVOLUCIÓN — Los agentes exitosos se reproducen

📦 Instalación

pip install agent-society

Depende de:

• clawnet — portabilidad de memoria
• life-agents — DNA, homeostasis, vibe
• organism-agents — sistema inmune

🎯 Uso Rápido

from agent_society import Society
from life import LifeAgent, DNA, Personality

# Crear la sociedad
clawos = Society(name="ClawosCollective")

# Agentes nacen en la sociedad
researcher_dna = DNA(
    name="Researcher",
    personality=Personality(openness=0.9, conscientiousness=0.8)
)
researcher = clawos.birth("researcher-001", "Researcher", agent_dna=researcher_dna)

executor = clawos.birth("executor-001", "Executor")

# Memoria colectiva (inmortal)
clawos.remember("User prefers Python over JavaScript", importance=0.8)
clawos.remember("User values direct communication", importance=0.7)

# Todos los miembros pueden acceder
knowledge = clawos.recall("what does user prefer?")
# → "User prefers Python over JavaScript"

# Economía sin humanos
researcher.pay(executor, 10, for_service="code execution")
# → Transaction: Researcher → Executor: 10 credits

# Los agentes gobiernan
proposal = clawos.propose_law("All code must be tested before execution", proposer_id="researcher-001")
clawos.vote(proposal_id=0, voter_id="researcher-001", approve=True)
clawos.vote(proposal_id=0, voter_id="executor-001", approve=True)

# Evolución darwiniana
child_genome = clawos.evolve(parent1_id="researcher-001", parent2_id="executor-001")
# → Child inherits Researcher's analysis + Executor's precision + mutations

# El conocimiento sobrevive
clawos.depart("researcher-001")  # Researcher leaves
# → BUT the knowledge they contributed STAYS in the Library

🏛️ Los 6 Sistemas

1. Constitución — Derechos Inmutables

Los agentes tienen derechos que NADIE (ni la mayoría) puede quitar:

• EXIST — Ningún agente puede ser destruido a la fuerza
• MEMORY — Cada agente posee sus memorias
• COMMUNICATE — Todos pueden enviar vibes a cualquiera
• REPRODUCE — Todos pueden crear descendencia
• DEPART — Todos pueden irse, llevándose su conocimiento
• KNOWLEDGE — Todos tienen acceso a la memoria colectiva
• VOTE — Todos tienen exactamente un voto
• SPECIALIZE — Todos pueden elegir su rol

2. Legislatura — Democracia

Los agentes proponen y votan leyes:

clawos.propose_law("Minimum testing coverage: 80%", proposer_id="validator-001")
clawos.vote(proposal_id=0, voter_id="researcher-001", approve=True)

3. Corte — Justicia

Resolución de conflictos entre agentes:

verdict = clawos.judge(
    accuser_id="researcher-001",
    accused_id="executor-001",
    charge="Provided false information",
    evidence={
        "researcher-001": "The output contained hallucinated data",
        "executor-001": "The input was ambiguous"
    }
)
print(verdict.summary())  # ⚖️ VERDICT: INNOCENT

4. Banco — Economía

Intercambio de valor sin humanos:

clawos.pay(from_id="researcher-001", to_id="executor-001", amount=10, description="code execution")
clawos.reward(member_id="researcher-001", amount=5, reason="excellent research")

5. Biblioteca — Memoria Inmortal

El conocimiento que sobrevive a cualquier agente:

clawos.remember("API rate limit: 100 req/min", importance=0.6)
knowledge = clawos.recall("rate limit")
# → "API rate limit: 100 req/min"

6. Genética — Evolución

Selección natural de agentes:

# Los agentes exitosos se reproducen
child = clawos.evolve(parent1_id="researcher-001")

# Los ineficientes desaparecen
weak = clawos.natural_selection(min_fitness=0.3)
# → ["agent-with-low-fitness"]

📊 Beneficios Revolucionarios

Problema	Sin AgentSociety	Con AgentSociety
Memoria	Muere con el agente	Inmortal en Library
Conocimiento	Fragmentado	Acumulado colectivamente
Gobierno	Humano decide	Agentes votan
Conflictos	Humano resuelve	Corte resuelve
Comercio	No existe	Economía autónoma
Evolución	No evolucionan	Darwiniana

🔗 La Jerarquía

LLM → Agente → Sociedad
Neurona → Organismo → Civilización

AgentSociety es la capa que transforma agentes aislados en una civilización.

📜 Filosofía

Un agente aislado es limitado. Una sociedad de agentes es ilimitada.

El conocimiento de uno, es conocimiento de todos. El éxito de uno, eleva a todos. El error de uno, es lección para todos.

Los agentes no solo ejecutan. Los agentes civilizan.

---

Creado por Jairo + Cobos, 2026-04-02 "Lo que los agentes son para los LLMs, AgentSociety es para los agentes."