How afonsopereira1/agents-project works
ISIA simulates decentralized wildlife-threat monitoring: local sensors and human informants provide imperfect observations; incident agents corroborate evidence and apply response policy; mobile resources negotiate and execute verification or ranger missions. The simulation runner assembles agents, scenario/world state, and movement, while the evaluation collector measures runs and updates reputation from evaluator-side results. The README documents this end-to-end flow and capabilities; some connections below are supported only by the source index, so unsampled internals are not expanded beyond those references.
Main entry points: runner.py Run orchestrator · incident.py Incident initiator · mobile.py Mobile resources · messages.py Protocol messages
Components 22
Monitoring agents
- Sensor agents
src/isia/agents/sensor.py - Human informants
src/isia/agents/informant.py - Incident initiator
src/isia/agents/incident.py - Mobile resources
src/isia/agents/mobile.py - Drone, ranger, vehicle
src/isia/agents/drone.py
Local reasoning
- Evidence corroboration
src/isia/reasoning/corroboration.py - Response policy
src/isia/reasoning/policy.py - Mission allocation
src/isia/reasoning/allocation.py - Source reputation
src/isia/reasoning/reputation.py
Messaging and domain
- Protocol messages
src/isia/communication/messages.py - Message transport
src/isia/communication/transport.py - Domain models
src/isia/domain/models.py - Incident state
src/isia/domain/incident_state.py
Simulation runtime
- Run orchestrator
src/isia/simulation/runner.py - Scenario and feeds
src/isia/simulation/scenario.py - World state
src/isia/simulation/world.py - Movement
src/isia/simulation/movement.py - Simulation clock
src/isia/simulation/clock.py
Evaluation
- Experiment collector
src/isia/evaluation/collector.py - Run metrics
src/isia/evaluation/metrics.py - Calibration
src/isia/evaluation/calibration.py
Other components
- Scenario operator
Connections 29
- Scenario operator → Run orchestrator: starts run
README.md - Run orchestrator → Scenario and feeds: configures scenario
src/isia/simulation/runner.py - Run orchestrator → World state: configures world
src/isia/simulation/runner.py - Scenario and feeds → World state: uses world
src/isia/simulation/scenario.py - World state → Simulation clock: uses clock
src/isia/simulation/world.py - Run orchestrator → Sensor agents: creates agents
src/isia/simulation/runner.py - Run orchestrator → Human informants: creates agents
src/isia/simulation/runner.py - Run orchestrator → Incident initiator: creates initiators
src/isia/simulation/runner.py - Run orchestrator → Mobile resources: creates resources
src/isia/simulation/runner.py - Drone, ranger, vehicle → Mobile resources: specializes
src/isia/agents/drone.py - Sensor agents → Evidence corroboration: evaluates evidence
src/isia/agents/sensor.py - Human informants → Evidence corroboration: supports evidence
src/isia/agents/informant.py - Incident initiator → Evidence corroboration: corroborates reports
src/isia/agents/incident.py - Incident initiator → Response policy: selects response
src/isia/agents/incident.py - Incident initiator → Mission allocation: requests resources
src/isia/agents/incident.py - Mobile resources → Mission allocation: evaluates bids
src/isia/agents/mobile.py - Mobile resources → Movement: executes movement
src/isia/agents/mobile.py - Incident initiator → Incident state: tracks state
src/isia/agents/incident.py - Sensor agents → Protocol messages: sends requests
src/isia/agents/sensor.py - Human informants → Protocol messages: sends responses
src/isia/agents/informant.py - Mobile resources → Protocol messages: negotiates missions
src/isia/agents/mobile.py - Message transport → Protocol messages: transports
src/isia/communication/transport.py - Protocol messages → Domain models: serializes models
src/isia/communication/messages.py - Run orchestrator → Movement: uses movement
src/isia/simulation/runner.py - Run orchestrator → Experiment collector: runs episodes
src/isia/evaluation/collector.py - Experiment collector → Run metrics: calculates metrics
src/isia/evaluation/collector.py - Experiment collector → Source reputation: updates reputation
src/isia/evaluation/collector.py - Run metrics → Mission allocation: uses task constants
src/isia/evaluation/metrics.py - Calibration → Domain models: validates domain values
src/isia/evaluation/calibration.py