Catalog PyPI
Back to packageRELEASE DETAILS

1.0.0

PyPI

agent-society-agents

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

Published2 Apr 2026
Direct dependencies6
Transitive dependenciesNot calculated

README

Version 1.0.0 documentation

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

ProblemaSin AgentSocietyCon AgentSociety
MemoriaMuere con el agenteInmortal en Library
ConocimientoFragmentadoAcumulado colectivamente
GobiernoHumano decideAgentes votan
ConflictosHumano resuelveCorte resuelve
ComercioNo existeEconomía autónoma
EvoluciónNo evolucionanDarwiniana

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

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 6

Native requirements
6 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
clawnet
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
clawnet>=3.0.0runtime
life-agents
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
life-agents>=1.0.0runtime
organism-agents
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
organism-agents>=1.0.0runtime
pytest
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
pytest; extra == "dev"runtime
black
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
black; extra == "dev"runtime
mypy
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.10",
  "evaluation": "NOT_EVALUATED"
}
mypy; extra == "dev"runtime

Distribution files

1 collected
agent_society_agents-1.0.0-py3-none-any.whl

bdist_wheel · 20.05 KB · Python py3

Source file

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 23:27 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:887bc3886d80b33becd142665e73d716e5df36d6dd0fdb3f263180dbf2089da1

Other collected versions

View all collected versions →