Skip to main content

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

Project description

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."

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agent_society_agents-1.0.0-py3-none-any.whl (20.5 kB view details)

Uploaded Python 3

File details

Details for the file agent_society_agents-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for agent_society_agents-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 035d769d585e3a3293556ea4216417f7f6a1eb68ec22e3f548623bbbf425ffee
MD5 9e22b355afb0a4c977968dab7df94778
BLAKE2b-256 41cd1e946c9834d305f0af9fa6c2dffdec1b2bbd7a14a8821467f99225c815ad

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page