How yasserfarouk/negmas works
Project type and purpose
• This is an open-source Python library (negmas) for building and running autonomous negotiation agents and simulations (“situated simultaneous negotiations”).
• It offers a public API, internal core modules, sample negotiators, negotiation protocols, utility‐function support, and a world simulation framework.
File structure
• Top‐level directories:
• src/negmas: the library’s Python package, split into many subpackages (common, events, mechanisms, negotiators, preferences, outcomes, sao, situated, etc.).
• docs/, notebooks/: user documentation and interactive examples.
• config/, etc/: sample configuration files and auxiliary scripts.
• tests/: unit and integration tests organized by module.
• scripts under src/negmas/scripts and run_*.sh: CLI entry points.
• Key configuration/deployment files: pyproject.toml, tox.ini, GitHub workflows under .github, README.rst, setup-related files.
• External dependency: a JAR file (“jnegmas”) under src/negmas/external for Genius integration.
README for additional insights
• Public API vs. internal implementation is deliberately decoupled.
• Supports multiple concurrent negotiations (concurrent subpackage) and inter-session controllers.
• Core extensibility points:
– Negotiators (negmas.negotiators and negmas.sao.negotiators)
– Mechanisms (negmas and negmas.sao modules)
– Worlds (negmas.situated)
– Utility functions (negmas.preferences)