# yoheinakajima/babyagi_archive architecture

> Architecture diagram of the GitHub repository yoheinakajima/babyagi_archive, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yoheinakajima/babyagi_archive
- Repository: https://github.com/yoheinakajima/babyagi_archive

## Overview

This archive centers on an autonomous task manager: a user supplies an objective and initial task; BabyAGI executes tasks with an LLM, stores results for context, then creates and reprioritizes follow-up work. Separate historical implementations extend the idea with skill/task registries, chat, and codebase embeddings. The README establishes the main runtime cycle; source-index references support the extension and registry links. Several listed subsystems are unsampled, so their internal flows are not expanded.

Main entry points: [`babyagi.py`](https://github.com/yoheinakajima/babyagi_archive/blob/main/babyagi.py) (BabyAGI runner), [`classic/BabyElfAGI/skills/skill_registry.py`](https://github.com/yoheinakajima/babyagi_archive/blob/main/classic/BabyElfAGI/skills/skill_registry.py) (Elf skill registry), [`classic/BabyElfAGI/main.py`](https://github.com/yoheinakajima/babyagi_archive/blob/main/classic/BabyElfAGI/main.py) (Elf agent loop), [`classic/babyfoxagi/main.py`](https://github.com/yoheinakajima/babyagi_archive/blob/main/classic/babyfoxagi/main.py) (Fox chat interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Autonomous task loop"]
  node_babyagi["BabyAGI runner<br/>[babyagi.py]"]
  node_execution["Task execution<br/>[babyagi.py]"]
  node_task_agents["Task generation<br/>[babyagi.py]"]
  node_priority["Task prioritization<br/>[babyagi.py]"]
  node_runtime_options["Runtime options<br/>[argparseext.py]"]
  node_human_mode["Human execution<br/>[human_mode.py]"]
end

subgraph group_storage["Results and coordination"]
  node_default_store[("Chroma results<br/>[babyagi.py]")]
  node_weaviate_store[("Weaviate results")]
  node_pinecone_store[("Pinecone results")]
  node_ray_tasks["Shared task list<br/>[ray_tasks.py]"]
  node_ray_objectives[("Shared objectives<br/>[ray_objectives.py]")]
end

subgraph group_elf["Elf skill agent"]
  node_elf_main["Elf agent loop<br/>[main.py]"]
  node_elf_tasks["Elf task registry<br/>[task_registry.py]"]
  node_elf_skills["Elf skill registry<br/>[skill_registry.py]"]
  node_elf_skill_base["Skill interface<br/>[skill.py]"]
  node_elf_web["Web research skill<br/>[web_search.py]"]
end

subgraph group_fox["Fox chat agent"]
  node_fox_ui["Fox chat interface<br/>[main.py]"]
  node_fox_logic["Fox task and skill logic<br/>[babyagi.py]"]
  node_fox_ongoing[("Ongoing task state<br/>[ongoing_tasks.py]")]
  node_fox_skillset["Fox skill extensions"]
end

subgraph group_alternates["Other implementations"]
  node_coder["Codebase assistant<br/>[babycoder.py]"]
  node_coder_embeddings[("Repository embeddings<br/>[embeddings.py]")]
  node_classic_agents["Classic agent variants"]
  node_node_agent["Node.js agent<br/>[babyagi.js]"]
end

node_user(("Objective setter"))
node_openai["OpenAI models"]

node_user -->|"sets objective"| node_babyagi
node_babyagi -->|"dispatches task"| node_execution
node_execution -->|"requests completion"| node_openai
node_execution -->|"stores result"| node_default_store
node_babyagi -->|"retrieves context"| node_default_store
node_babyagi -->|"creates tasks"| node_task_agents
node_task_agents -->|"requests tasks"| node_openai
node_babyagi -->|"reprioritizes list"| node_priority
node_priority -->|"requests ordering"| node_openai
node_babyagi -.->|"selects optional storage"| node_weaviate_store
node_babyagi -.->|"selects optional storage"| node_pinecone_store
node_babyagi -.->|"uses shared tasks"| node_ray_tasks
node_ray_tasks -->|"registers objective"| node_ray_objectives
node_babyagi -->|"loads options"| node_runtime_options
node_babyagi -.->|"supports manual execution"| node_human_mode
node_elf_main -->|"creates and updates"| node_elf_tasks
node_elf_main -->|"initializes registry"| node_elf_skills
node_elf_tasks -->|"dispatches skill"| node_elf_skills
node_elf_skills -->|"uses interface"| node_elf_skill_base
node_elf_web -->|"implements"| node_elf_skill_base
node_fox_ui -->|"calls agent logic"| node_fox_logic
node_fox_ui -->|"updates task state"| node_fox_ongoing
node_fox_logic -->|"tracks task state"| node_fox_ongoing
node_coder -->|"uses embeddings"| node_coder_embeddings

click node_babyagi "https://github.com/yoheinakajima/babyagi_archive/blob/main/babyagi.py"
click node_execution "https://github.com/yoheinakajima/babyagi_archive/blob/main/babyagi.py"
click node_task_agents "https://github.com/yoheinakajima/babyagi_archive/blob/main/babyagi.py"
click node_priority "https://github.com/yoheinakajima/babyagi_archive/blob/main/babyagi.py"
click node_default_store "https://github.com/yoheinakajima/babyagi_archive/blob/main/babyagi.py"
click node_weaviate_store "https://github.com/yoheinakajima/babyagi_archive/blob/main/extensions/weaviate_storage.py"
click node_pinecone_store "https://github.com/yoheinakajima/babyagi_archive/blob/main/extensions/pinecone_storage.py"
click node_ray_tasks "https://github.com/yoheinakajima/babyagi_archive/blob/main/extensions/ray_tasks.py"
click node_ray_objectives "https://github.com/yoheinakajima/babyagi_archive/blob/main/extensions/ray_objectives.py"
click node_runtime_options "https://github.com/yoheinakajima/babyagi_archive/blob/main/extensions/argparseext.py"
click node_human_mode "https://github.com/yoheinakajima/babyagi_archive/blob/main/extensions/human_mode.py"
click node_elf_main "https://github.com/yoheinakajima/babyagi_archive/blob/main/classic/BabyElfAGI/main.py"
click node_elf_tasks "https://github.com/yoheinakajima/babyagi_archive/blob/main/classic/BabyElfAGI/tasks/task_registry.py"
click node_elf_skills "https://github.com/yoheinakajima/babyagi_archive/blob/main/classic/BabyElfAGI/skills/skill_registry.py"
click node_elf_skill_base "https://github.com/yoheinakajima/babyagi_archive/blob/main/classic/BabyElfAGI/skills/skill.py"
click node_elf_web "https://github.com/yoheinakajima/babyagi_archive/blob/main/classic/BabyElfAGI/skills/web_search.py"
click node_fox_ui "https://github.com/yoheinakajima/babyagi_archive/blob/main/classic/babyfoxagi/main.py"
click node_fox_logic "https://github.com/yoheinakajima/babyagi_archive/blob/main/classic/babyfoxagi/babyagi.py"
click node_fox_ongoing "https://github.com/yoheinakajima/babyagi_archive/blob/main/classic/babyfoxagi/ongoing_tasks.py"
click node_fox_skillset "https://github.com/yoheinakajima/babyagi_archive/tree/main/classic/babyfoxagi/skills"
click node_coder "https://github.com/yoheinakajima/babyagi_archive/blob/main/babycoder/babycoder.py"
click node_coder_embeddings "https://github.com/yoheinakajima/babyagi_archive/blob/main/babycoder/embeddings.py"
click node_classic_agents "https://github.com/yoheinakajima/babyagi_archive/tree/main/classic"
click node_node_agent "https://github.com/yoheinakajima/babyagi_archive/blob/main/node/babyagi.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_babyagi,node_execution,node_task_agents,node_priority,node_runtime_options,node_human_mode toneBlue
class node_default_store,node_weaviate_store,node_pinecone_store,node_ray_tasks,node_ray_objectives toneAmber
class node_elf_main,node_elf_tasks,node_elf_skills,node_elf_skill_base,node_elf_web toneMint
class node_fox_ui,node_fox_logic,node_fox_ongoing,node_fox_skillset toneRose
class node_coder,node_coder_embeddings,node_classic_agents,node_node_agent,node_user,node_openai toneIndigo
```

## Components

### Autonomous task loop

- [BabyAGI runner](https://github.com/yoheinakajima/babyagi_archive/blob/main/babyagi.py): `babyagi.py`
- [Task execution](https://github.com/yoheinakajima/babyagi_archive/blob/main/babyagi.py): `babyagi.py`
- [Task generation](https://github.com/yoheinakajima/babyagi_archive/blob/main/babyagi.py): `babyagi.py`
- [Task prioritization](https://github.com/yoheinakajima/babyagi_archive/blob/main/babyagi.py): `babyagi.py`
- [Runtime options](https://github.com/yoheinakajima/babyagi_archive/blob/main/extensions/argparseext.py): `extensions/argparseext.py`
- [Human execution](https://github.com/yoheinakajima/babyagi_archive/blob/main/extensions/human_mode.py): `extensions/human_mode.py`

### Results and coordination

- [Chroma results](https://github.com/yoheinakajima/babyagi_archive/blob/main/babyagi.py): `babyagi.py`
- [Weaviate results](https://github.com/yoheinakajima/babyagi_archive/blob/main/extensions/weaviate_storage.py): `extensions/weaviate_storage.py`
- [Pinecone results](https://github.com/yoheinakajima/babyagi_archive/blob/main/extensions/pinecone_storage.py): `extensions/pinecone_storage.py`
- [Shared task list](https://github.com/yoheinakajima/babyagi_archive/blob/main/extensions/ray_tasks.py): `extensions/ray_tasks.py`
- [Shared objectives](https://github.com/yoheinakajima/babyagi_archive/blob/main/extensions/ray_objectives.py): `extensions/ray_objectives.py`

### Elf skill agent

- [Elf agent loop](https://github.com/yoheinakajima/babyagi_archive/blob/main/classic/BabyElfAGI/main.py): `classic/BabyElfAGI/main.py`
- [Elf task registry](https://github.com/yoheinakajima/babyagi_archive/blob/main/classic/BabyElfAGI/tasks/task_registry.py): `classic/BabyElfAGI/tasks/task_registry.py`
- [Elf skill registry](https://github.com/yoheinakajima/babyagi_archive/blob/main/classic/BabyElfAGI/skills/skill_registry.py): `classic/BabyElfAGI/skills/skill_registry.py`
- [Skill interface](https://github.com/yoheinakajima/babyagi_archive/blob/main/classic/BabyElfAGI/skills/skill.py): `classic/BabyElfAGI/skills/skill.py`
- [Web research skill](https://github.com/yoheinakajima/babyagi_archive/blob/main/classic/BabyElfAGI/skills/web_search.py): `classic/BabyElfAGI/skills/web_search.py`

### Fox chat agent

- [Fox chat interface](https://github.com/yoheinakajima/babyagi_archive/blob/main/classic/babyfoxagi/main.py): `classic/babyfoxagi/main.py`
- [Fox task and skill logic](https://github.com/yoheinakajima/babyagi_archive/blob/main/classic/babyfoxagi/babyagi.py): `classic/babyfoxagi/babyagi.py`
- [Ongoing task state](https://github.com/yoheinakajima/babyagi_archive/blob/main/classic/babyfoxagi/ongoing_tasks.py): `classic/babyfoxagi/ongoing_tasks.py`
- [Fox skill extensions](https://github.com/yoheinakajima/babyagi_archive/tree/main/classic/babyfoxagi/skills): `classic/babyfoxagi/skills`

### Other implementations

- [Codebase assistant](https://github.com/yoheinakajima/babyagi_archive/blob/main/babycoder/babycoder.py): `babycoder/babycoder.py`
- [Repository embeddings](https://github.com/yoheinakajima/babyagi_archive/blob/main/babycoder/embeddings.py): `babycoder/embeddings.py`
- [Classic agent variants](https://github.com/yoheinakajima/babyagi_archive/tree/main/classic): `classic`
- [Node.js agent](https://github.com/yoheinakajima/babyagi_archive/blob/main/node/babyagi.js): `node/babyagi.js`

### Other components

- **Objective setter**
- **OpenAI models**

## Connections

- Objective setter → BabyAGI runner: sets objective (evidence: `README.md`)
- BabyAGI runner → Task execution: dispatches task (evidence: `README.md`)
- Task execution → OpenAI models: requests completion (evidence: `README.md`)
- Task execution → Chroma results: stores result (evidence: `README.md`)
- BabyAGI runner → Chroma results: retrieves context (evidence: `README.md`)
- BabyAGI runner → Task generation: creates tasks (evidence: `README.md`)
- Task generation → OpenAI models: requests tasks (evidence: `README.md`)
- BabyAGI runner → Task prioritization: reprioritizes list (evidence: `README.md`)
- Task prioritization → OpenAI models: requests ordering (evidence: `README.md`)
- BabyAGI runner → Weaviate results: selects optional storage (evidence: `babyagi.py`)
- BabyAGI runner → Pinecone results: selects optional storage (evidence: `babyagi.py`)
- BabyAGI runner → Shared task list: uses shared tasks (evidence: `babyagi.py`)
- Shared task list → Shared objectives: registers objective (evidence: `extensions/ray_tasks.py`)
- BabyAGI runner → Runtime options: loads options (evidence: `babyagi.py`)
- BabyAGI runner → Human execution: supports manual execution (evidence: `babyagi.py`)
- Elf agent loop → Elf task registry: creates and updates (evidence: `classic/BabyElfAGI/main.py`)
- Elf agent loop → Elf skill registry: initializes registry (evidence: `classic/BabyElfAGI/main.py`)
- Elf task registry → Elf skill registry: dispatches skill (evidence: `classic/BabyElfAGI/tasks/task_registry.py`)
- Elf skill registry → Skill interface: uses interface (evidence: `classic/BabyElfAGI/skills/skill_registry.py`)
- Web research skill → Skill interface: implements (evidence: `classic/BabyElfAGI/skills/web_search.py`)
- Fox chat interface → Fox task and skill logic: calls agent logic (evidence: `classic/babyfoxagi/main.py`)
- Fox chat interface → Ongoing task state: updates task state (evidence: `classic/babyfoxagi/main.py`)
- Fox task and skill logic → Ongoing task state: tracks task state (evidence: `classic/babyfoxagi/babyagi.py`)
- Codebase assistant → Repository embeddings: uses embeddings (evidence: `babycoder/babycoder.py`)
