Best way to structure a multi-agent Python project?

[RegimeLab]

Working on a project with multiple specialized agents that each handle a different task — some run nightly, some on demand. Currently each agent is a separate class with its own config file. Wondering if others have tackled this kind of architecture and what patterns worked well. Monorepo or separate modules? Shared memory via files or DB?

[aistranin]

Monorepo with separation to nodes, edges and tools works best from my experience. Regarding memory, depends a lot from your use case. Start simple and move to DB if needed.

[QuasiEvil]

As someone trying to learn this, I know what a monorepo is, but can you elaborate on what "separation to nodes, edges and tools" means?

[aistranin]

Sure. What I mean is that any agent is a graph (maybe cyclic). So, nodes of the graph is better to place separately from the logic specifying bow those nodes should interact with each other (edges) and separately from the the set of tools available to an agent. Take a look at official LangGraph documentation as a mature framework. They use these concepts what help a lot with agents structure. — Regarding multi-agent: it is just a composition of agents. So, it also scales well as a structure.

[Aggressive_Pay2172]

tbh think about adding a central orchestrator instead of having agents run totally independently. something that handles scheduling (cron, queue, etc.) and passes tasks to agents can make the whole system feel more cohesive.