How ltjed/freephdlabor works
freephdlabor is a multiagent research automation framework. A user submits a research task through the launcher; the ManagerAgent coordinates ideation, experiments, resource preparation, paper writing, review, and proofreading, iterating on feedback before delivering a manuscript. Supporting capabilities include workspace-based code execution, web and paper research, human interaction, and context management. The README documents the workflow; source-index references and excerpts support the main orchestration and agent/tool relationships. Several tool implementations and integrations were not sampled, so their internal links are omitted.
Main entry points: manager_agent.py Manager Agent · writeup_agent.py Paper Writing · base_research_agent.py Agent Foundation · reviewer_agent.py Paper Review
Components 24
Orchestration
- Task Launcher
launch_multiagent.py - Manager Agent
freephdlabor/agents/manager_agent.py - Agent Foundation
freephdlabor/agents/base_research_agent.py - Agent Instructions
freephdlabor/prompts/system_prompt_template.py - Human Interaction
freephdlabor/interaction/callback_tools.py
Research Stages
- Idea Generation
freephdlabor/agents/ideation_agent.py - Idea Tools
freephdlabor/toolkits/idea_generation_toolkit.py - Experimentation
freephdlabor/agents/experimentation_agent.py - Experiment Tools
freephdlabor/toolkits/run_experiment_tool.py - Experiment Search
external_tools/run_experiment_tool/ai_scientist/treesearch/perform_experiments_bfts_with_agentmanager.py - Resource Preparation
freephdlabor/agents/resource_preparation_agent.py - Research Tools
freephdlabor/toolkits/general_tools/open_deep_search/ods_tool.py
Paper Production
- Paper Writing
freephdlabor/agents/writeup_agent.py - LaTeX Generation
freephdlabor/toolkits/writeup/latex_generator_tool.py - Paper Analysis
freephdlabor/toolkits/writeup/latex_reflection_tool.py - Paper Review
freephdlabor/agents/reviewer_agent.py - Document Review
freephdlabor/toolkits/writeup/vlm_document_analysis_tool.py - Proofreading
freephdlabor/agents/proofreading_agent.py
Runtime Support
- Workspace Executor
freephdlabor/interpreters/workspace_executor.py - Workspace Files
freephdlabor/toolkits/general_tools/file_editing/file_editing_tools.py - LLM Access
freephdlabor/llm.py - Agent Supervision
freephdlabor/supervision/supervision_manager.py - Context Management
freephdlabor/agents/context_compaction.py
Other components
- Researcher
Connections 28
- Researcher → Task Launcher: submits task
- Task Launcher → Manager Agent: starts workflow
- Manager Agent → Idea Generation: delegates ideation
freephdlabor/agents/manager_agent.py - Manager Agent → Experimentation: delegates experiments
freephdlabor/agents/manager_agent.py - Manager Agent → Resource Preparation: delegates preparation
freephdlabor/agents/manager_agent.py - Manager Agent → Paper Writing: delegates writing
freephdlabor/agents/manager_agent.py - Manager Agent → Paper Review: delegates review
freephdlabor/agents/manager_agent.py - Manager Agent → Proofreading: delegates proofreading
freephdlabor/utils.py - Manager Agent → Workspace Files: uses workspace tools
freephdlabor/agents/manager_agent.py - Manager Agent → Human Interaction: supports feedback
- Manager Agent → Agent Instructions: uses instructions
- Idea Generation → Idea Tools: uses idea tools
- Idea Generation → Research Tools: researches literature
- Experimentation → Experiment Tools: uses experiment tools
- Experiment Tools → Experiment Search: runs experiments
- Experimentation → Workspace Executor: executes code
- Resource Preparation → Workspace Files: organizes workspace
- Paper Writing → LaTeX Generation: generates LaTeX
freephdlabor/agents/writeup_agent.py - Paper Writing → Paper Analysis: reflects on draft
freephdlabor/agents/writeup_agent.py - Paper Review → Document Review: analyzes paper
freephdlabor/agents/reviewer_agent.py - Paper Review → Workspace Files: accesses workspace
freephdlabor/agents/reviewer_agent.py - Paper Writing → Paper Review: submits for review
- Manager Agent → Paper Writing: requests revisions
freephdlabor/agents/manager_agent.py - Manager Agent → Agent Foundation: inherits agent support
freephdlabor/agents/manager_agent.py - Agent Foundation → Workspace Executor: creates executor
freephdlabor/agents/base_research_agent.py - Agent Foundation → Context Management: compacts context
freephdlabor/agents/base_research_agent.py - Agent Foundation → LLM Access: logs model calls
freephdlabor/agents/base_research_agent.py - Manager Agent → Agent Supervision: supervises output