whatisgithub

What is 3and_agents?

g-wellsa/3and_agents — explained in plain English

Analysis updated 2026-05-18

29PythonAudience · pm founderComplexity · 3/5LicenseSetup · moderate

In one sentence

A Python framework where a dispatcher agent routes one request to a research agent and an executor agent working in parallel, then reviews and scores their combined output.

Mindmap

mindmap
  root((3And agents))
    What it does
      Route requests
      Research in parallel
      Execute in parallel
      Score results
    Tech stack
      Python
      Redis Streams
      SQLite
      DeepSeek API
    Use cases
      Landing pages
      Market reports
      Data scripts
      HTML5 games
    Audience
      Business users
      Founders
    Modes
      Lightweight
      Full Docker

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate a business sales landing page from a single sentence of input.

USE CASE 2

Produce a market research report on a topic using the research agent.

USE CASE 3

Build a small playable HTML5 game with the executor agent.

USE CASE 4

Write a data-cleaning script without switching between multiple AI tools yourself.

What is it built with?

PythonRedisSQLiteGradioDocker

How does it compare?

g-wellsa/3and_agentsadityasharmadotai-hash/docs-reader-rag-agentalekseiul/hermes-researcher-agent
Stars292929
LanguagePythonPythonPython
Setup difficultymoderateeasymoderate
Complexity3/52/52/5
Audiencepm foundervibe coderresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Lightweight mode needs only Python and a DeepSeek API key, full mode needs Docker for the Redis message bus.

MIT license: free to use, modify, and distribute, including for commercial purposes, as long as the copyright notice is kept.

So what is it?

3And (三和, Sanhe) is a Python framework that replaces the usual single-AI-answers-one-question pattern with a three-agent team that divides tasks automatically. You type one request, and three specialized agents handle it in parallel: a dispatcher that reads the intent and routes the work, a research agent that handles market analysis and information gathering, and an executor that writes code, builds web pages, or creates small games. When both working agents finish, the dispatcher reviews the results and attaches a confidence score and quality rating before delivering the output. The README is written primarily in Chinese and frames the project at business users: examples include generating a sales landing page, writing a market research report on Chinese AI companies, producing a data-cleaning script, and building a playable HTML5 game, all from a single sentence of input. The architecture uses Redis Streams as the message bus between agents. There are eight named message channels covering task dispatch, acknowledgment, progress updates, completion, failure, subtasks, interrupts, and heartbeats. Each working agent breaks its assigned task into a directed graph of subtasks (up to 10 nodes) and distributes them to a pool of workers that each call the DeepSeek language model API. Task state is stored in an SQLite database. Completed files are served through a file browser running on a separate port. The system runs in two modes. A lightweight mode requires only Python and a DeepSeek API key, with Redis disabled and a Gradio web interface on port 7860. A full Docker mode adds the Redis message bus for concurrent multi-agent processing. Adding a new task type involves three steps: registering a routing rule in the config file, adding a prompt template, and adding the name to the web interface. The project includes 123 automated tests that the README reports as all passing. It is MIT-licensed.

Copy-paste prompts

Prompt 1
Set up 3And in lightweight mode with just a DeepSeek API key and no Redis.
Prompt 2
Have the dispatcher agent route my request to build a landing page for my product.
Prompt 3
Show me how to add a new task type by registering a routing rule and prompt template.
Prompt 4
Explain how the dispatcher scores the confidence and quality of the final output.

Frequently asked questions

What is 3and_agents?

A Python framework where a dispatcher agent routes one request to a research agent and an executor agent working in parallel, then reviews and scores their combined output.

What language is 3and_agents written in?

Mainly Python. The stack also includes Python, Redis, SQLite.

What license does 3and_agents use?

MIT license: free to use, modify, and distribute, including for commercial purposes, as long as the copyright notice is kept.

How hard is 3and_agents to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is 3and_agents for?

Mainly pm founder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.