Skip to content

Latest commit

ย 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Version Python License Tests Templates

AgentForge Studio โ€” ่ฝป้‡็บง็ปˆ็ซฏ AI Agent ๆŠ€่ƒฝๅทฅๅŽ‚ไธŽๅ›ข้˜Ÿ็ผ–ๆŽ’ๅผ•ๆ“Ž

็ฎ€ไฝ“ไธญๆ–‡ | ็น้ซ”ไธญๆ–‡ | English | ๆ—ฅๆœฌ่ชž | ํ•œ๊ตญ์–ด | Espaรฑol


๐ŸŽ‰ AgentForge Studio

็”จ็ปˆ็ซฏๆ‰“้€ ไฝ ็š„ AI Agent ๅ†›ๅ›ข โ€”โ€” ่ฝป้‡ใ€้ซ˜ๆ•ˆใ€ๅผ€็ฎฑๅณ็”จใ€‚

AgentForge Studio ๆ˜ฏไธ€ไธช่ฟ่กŒๅœจ็ปˆ็ซฏไธญ็š„ AI Agent ๆŠ€่ƒฝๅทฅๅŽ‚ไธŽๅ›ข้˜Ÿ็ผ–ๆŽ’ๅผ•ๆ“Žใ€‚ๅฎƒ่ฎฉไฝ ่ƒฝๅคŸๅƒๆญ็งฏๆœจไธ€ๆ ทๅˆ›ๅปบใ€็ฎก็†ๅ’Œ็ผ–ๆŽ’ AI Agent ๆŠ€่ƒฝ๏ผŒๅนถ้€š่ฟ‡ DAG ไพ่ต–ๅ›พๅฎž็Žฐๅคš Agent ๅ›ข้˜Ÿๅไฝœใ€‚ๆ— ้œ€ๅคๆ‚้…็ฝฎ๏ผŒไธ€ๆกๅ‘ฝไปคๅณๅฏๅฏๅŠจไฝ ็š„ AI ๅทฅๅŠใ€‚

GitHub: https://github.com/gitstq/AgentForge-Studio


โœจ ๆ ธๅฟƒ็‰นๆ€ง

็‰นๆ€ง ่ฏดๆ˜Ž
๐Ÿ› ๏ธ ๆŠ€่ƒฝ็ฎก็† ๅˆ›ๅปบใ€็ผ–่พ‘ใ€ๆต‹่ฏ•ใ€ๅฏผๅ‡บ AI Agent ๆŠ€่ƒฝ๏ผŒๅฎŒๆ•ด็”Ÿๅ‘ฝๅ‘จๆœŸ็ฎก็†
๐Ÿค– Agent ็ฎก็† ๅˆ›ๅปบ Agent ๅนถ็ตๆดปๅˆ†้…ๆŠ€่ƒฝ๏ผŒๆ‰“้€ ไธ“ๅฑž AI ๅŠฉๆ‰‹
๐Ÿ”„ ๅ›ข้˜Ÿ็ผ–ๆŽ’ ๅŸบไบŽ DAG ไพ่ต–ๅ›พ็ผ–ๆŽ’ๅคš Agent ๅ›ข้˜Ÿๅไฝœ๏ผŒๆ”ฏๆŒๅฏ่ง†ๅŒ–
๐Ÿ“‹ 20+ ๅ†…็ฝฎๆจกๆฟ ไปฃ็ ๅฎกๆŸฅใ€ๆ–‡ๆกฃ็”Ÿๆˆใ€ๅฎ‰ๅ…จๆ‰ซๆใ€ๆ•ฐๆฎๅˆ†ๆž็ญ‰ๅผ€็ฎฑๅณ็”จ
๐Ÿ“ค MCP ๅฏผๅ‡บ ๆŠ€่ƒฝไธ€้”ฎๅฏผๅ‡บไธบ MCP Server ๆ ผๅผ๏ผŒๆ— ็ผๅฏนๆŽฅ LLM ็”Ÿๆ€
๐Ÿงช ๆต‹่ฏ•ๆฒ™็ฎฑ ็‹ฌ็ซ‹ๆต‹่ฏ•ๆฏไธชๆŠ€่ƒฝ๏ผŒ็กฎไฟ่ดจ้‡ๅฏ้ 
๐Ÿ“Š TUI ไปช่กจ็›˜ Rich ็ปˆ็ซฏไบคไบ’็•Œ้ข๏ผŒไฟกๆฏไธ€็›ฎไบ†็„ถ
โœ… 84 ไธชๅ•ๅ…ƒๆต‹่ฏ• ๅ…จ้ƒจ้€š่ฟ‡๏ผŒไปฃ็ ่ดจ้‡ๆœ‰ไฟ้šœ

๐Ÿš€ ๅฟซ้€Ÿๅผ€ๅง‹

๐Ÿ“‹ ็Žฏๅขƒ่ฆๆฑ‚

  • Python 3.9 ๆˆ–ๆ›ด้ซ˜็‰ˆๆœฌ
  • pip ๅŒ…็ฎก็†ๅ™จ
  • ็ปˆ็ซฏ๏ผˆๆŽจ่ๆ”ฏๆŒ 256 ่‰ฒ็š„็ปˆ็ซฏไปฅ่Žทๅพ—ๆœ€ไฝณไฝ“้ชŒ๏ผ‰

๐Ÿ”ง ๅฎ‰่ฃ…ๆญฅ้ชค

# ๅ…‹้š†้กน็›ฎ
git clone https://github.com/gitstq/AgentForge-Studio.git
cd AgentForge-Studio

# ๅฎ‰่ฃ…ไพ่ต–
pip install -r requirements.txt

# ๅฎ‰่ฃ…้กน็›ฎ๏ผˆๅฏ้€‰๏ผŒๆณจๅ†Œ agentforge ๅ‘ฝไปค๏ผ‰
pip install -e .

๐ŸŽฎ ไฝฟ็”จๅ‘ฝไปค

# ๆŸฅ็œ‹็‰ˆๆœฌ
agentforge --version

# ๅˆๅง‹ๅŒ–้กน็›ฎ
agentforge init

# ๅฏๅŠจ TUI ไปช่กจ็›˜
agentforge dashboard

๐Ÿ“– ่ฏฆ็ป†ไฝฟ็”จๆŒ‡ๅ—

๐Ÿ› ๏ธ ๆŠ€่ƒฝ็ฎก็†

ๆŠ€่ƒฝๆ˜ฏ AgentForge ็š„ๆ ธๅฟƒๆž„ๅปบๅ•ๅ…ƒใ€‚ๆฏไธชๆŠ€่ƒฝๅฎšไน‰ไบ† AI Agent ๅฏไปฅๆ‰ง่กŒ็š„ๅ…ทไฝ“่ƒฝๅŠ›ใ€‚

# ๅˆ›ๅปบๆ–ฐๆŠ€่ƒฝ
agentforge skill create my-reviewer \
  --description "ไปฃ็ ๅฎกๆŸฅไธ“ๅฎถ" \
  --instructions "ไฝ ๆ˜ฏไธ€ไฝ่ต„ๆทฑไปฃ็ ๅฎกๆŸฅไธ“ๅฎถ๏ผŒ่ฏทไป”็ป†ๅฎกๆŸฅไปฃ็ ่ดจ้‡..."

# ๆŸฅ็œ‹ๆ‰€ๆœ‰ๆŠ€่ƒฝ
agentforge skill list

# ๆŸฅ็œ‹ๆŠ€่ƒฝ่ฏฆๆƒ…
agentforge skill show my-reviewer

# ๆต‹่ฏ•ๆŠ€่ƒฝ
agentforge skill test my-reviewer

# ๅฏผๅ‡บๆŠ€่ƒฝไธบ MCP ๆ ผๅผ
agentforge skill export my-reviewer --format mcp --output my-reviewer.json

๐Ÿค– Agent ็ฎก็†

Agent ๆ˜ฏๆŠ€่ƒฝ็š„่ฝฝไฝ“๏ผŒไฝ ๅฏไปฅไธบๆฏไธช Agent ๅˆ†้…ไธๅŒ็š„ๆŠ€่ƒฝ็ป„ๅˆใ€‚

# ๅˆ›ๅปบ Agent
agentforge agent create senior-dev \
  --role "้ซ˜็บงๅผ€ๅ‘ๅทฅ็จ‹ๅธˆ" \
  --system-prompt "ไฝ ๆ˜ฏไธ€ไฝ็ป้ชŒไธฐๅฏŒ็š„้ซ˜็บงๅผ€ๅ‘ๅทฅ็จ‹ๅธˆ..." \
  --model gpt-4

# ๆŸฅ็œ‹ๆ‰€ๆœ‰ Agent
agentforge agent list

# ไธบ Agent ๅˆ†้…ๆŠ€่ƒฝ
agentforge agent assign senior-dev my-reviewer

๐Ÿ”„ ๅ›ข้˜Ÿ็ผ–ๆŽ’

้€š่ฟ‡ DAG๏ผˆๆœ‰ๅ‘ๆ— ็Žฏๅ›พ๏ผ‰ไพ่ต–ๅ…ณ็ณป็ผ–ๆŽ’ๅคšไธช Agent ๅๅŒๅทฅไฝœใ€‚

# ๅˆ›ๅปบๅ›ข้˜Ÿ
agentforge team create dev-team --description "ๅผ€ๅ‘ๆตๆฐด็บฟๅ›ข้˜Ÿ"

# ๆทปๅŠ  Agent ๅˆฐๅ›ข้˜Ÿ๏ผˆๆ”ฏๆŒไพ่ต–ๅฃฐๆ˜Ž๏ผ‰
agentforge team add dev-team code-reviewer
agentforge team add dev-team bug-fixer --depends-on code-reviewer
agentforge team add dev-team test-gen --depends-on bug-fixer

# ๅฏ่ง†ๅŒ–ๅ›ข้˜Ÿ DAG ็ป“ๆž„
agentforge team visualize dev-team

# ๆ‰ง่กŒๅ›ข้˜Ÿ็ผ–ๆŽ’
agentforge team run dev-team

๐Ÿ“‹ ๆจกๆฟไฝฟ็”จ

AgentForge ๅ†…็ฝฎไบ† 20+ ไธช็ฒพๅฟƒ่ฎพ่ฎก็š„ๆŠ€่ƒฝๆจกๆฟ๏ผŒ่ฆ†็›–ๅผ€ๅ‘ๅ…จๆต็จ‹๏ผš

ๆจกๆฟๅ ็”จ้€”
code-review ไปฃ็ ๅฎกๆŸฅ๏ผŒๆฃ€ๆต‹ Bug ๅ’Œ่ดจ้‡้—ฎ้ข˜
doc-generator ไปŽๆบ็ ๆˆ–ๆ่ฟฐ็”Ÿๆˆๆ–‡ๆกฃ
data-analyst ๆ•ฐๆฎๅˆ†ๆžไธŽๆดžๅฏŸ็”Ÿๆˆ
api-tester API ็ซฏ็‚นๆต‹่ฏ•็”จไพ‹็”Ÿๆˆ
security-scanner ๅฎ‰ๅ…จๆผๆดžๆ‰ซๆ๏ผˆOWASP Top 10๏ผ‰
code-refactorer ไปฃ็ ้‡ๆž„ไธŽไผ˜ๅŒ–
translator ๅคš่ฏญ่จ€็ฟป่ฏ‘
summarizer ๆ–‡ๆœฌๆ‘˜่ฆ็”Ÿๆˆ
bug-fixer Bug ๅฎšไฝไธŽไฟฎๅค
perf-optimizer ๆ€ง่ƒฝไผ˜ๅŒ–ๅปบ่ฎฎ
test-generator ๅ•ๅ…ƒๆต‹่ฏ•ไธŽ้›†ๆˆๆต‹่ฏ•็”Ÿๆˆ
code-explainer ไปฃ็ ่งฃ้‡ŠไธŽ่ฏดๆ˜Ž
req-analyst ้œ€ๆฑ‚ๅˆ†ๆžไธŽ็ป“ๆž„ๅŒ–
arch-designer ๆžถๆž„่ฎพ่ฎกไธŽๆจกๅผๆŽจ่
project-manager ้กน็›ฎ่ง„ๅˆ’ไธŽ็ฎก็†
code-migrator ่ทจ่ฏญ่จ€ไปฃ็ ่ฟ็งป
config-manager ้…็ฝฎๆ–‡ไปถ็”ŸๆˆไธŽ็ฎก็†
log-analyst ๆ—ฅๅฟ—ๅˆ†ๆžไธŽๆ•…้šœๆŽ’ๆŸฅ
deploy-helper ้ƒจ็ฝฒ้…็ฝฎไธŽ CI/CD ็”Ÿๆˆ
monitor-analyst ็›‘ๆŽงไธŽๅฏ่ง‚ๆต‹ๆ€งๆ–นๆกˆ่ฎพ่ฎก
# ๆŸฅ็œ‹ๆ‰€ๆœ‰ๅฏ็”จๆจกๆฟ
agentforge template list

# ๅŸบไบŽๆจกๆฟๅˆ›ๅปบๆŠ€่ƒฝ
agentforge template apply code-review my-custom-reviewer

๐Ÿ“ค ๅฏผๅ‡บๅŠŸ่ƒฝ

ๅฐ†ๆŠ€่ƒฝๅฏผๅ‡บไธบๆ ‡ๅ‡† MCP Server ๆ ผๅผ๏ผŒๆ— ็ผๆŽฅๅ…ฅ Claude Desktopใ€Cursor ็ญ‰ LLM ๅฎขๆˆท็ซฏใ€‚

# ๅฏผๅ‡บๅ•ไธชๆŠ€่ƒฝ
agentforge skill export my-skill --format mcp --output skill.json

# ๅฏผๅ‡บๅŽๅฏ็›ดๆŽฅ็”จไบŽ MCP ๅฎขๆˆท็ซฏ้…็ฝฎ

๐Ÿ’ก ่ฎพ่ฎกๆ€่ทฏไธŽ่ฟญไปฃ่ง„ๅˆ’

๐ŸŽฏ ่ฎพ่ฎก็†ๅฟต

AgentForge Studio ็š„ๆ ธๅฟƒ่ฎพ่ฎก็†ๅฟตๆ˜ฏ "ๆŠ€่ƒฝๅณ็งฏๆœจ๏ผŒAgent ๅณๅทฅๅŒ ๏ผŒๅ›ข้˜ŸๅณๅทฅๅŽ‚"๏ผš

  • ๆŠ€่ƒฝๅฑ‚๏ผˆSkill๏ผ‰๏ผšๅฎšไน‰ๅŽŸๅญๅŒ–็š„ AI ่ƒฝๅŠ›ๅ•ๅ…ƒ๏ผŒๅŒ…ๅซๆŒ‡ไปคใ€ๅ‚ๆ•ฐใ€่พ“ๅ…ฅ่พ“ๅ‡บ่ง„่Œƒ
  • Agent ๅฑ‚๏ผšๅฐ†ๆŠ€่ƒฝ็ป„ๅˆ่ต‹ไบˆ็‰นๅฎš่ง’่‰ฒ๏ผŒๅฝขๆˆไธ“ไธšๅŒ–็š„ AI ๅŠฉๆ‰‹
  • ๅ›ข้˜Ÿๅฑ‚๏ผˆTeam๏ผ‰๏ผš้€š่ฟ‡ DAG ไพ่ต–ๅ›พ็ผ–ๆŽ’ Agent ๆ‰ง่กŒ้กบๅบ๏ผŒๅฎž็Žฐๅคๆ‚ๅทฅไฝœๆต

๐Ÿ—บ๏ธ ่ฟญไปฃ่ง„ๅˆ’

  • v1.0 โœ… โ€” ๆ ธๅฟƒๅŠŸ่ƒฝ๏ผšๆŠ€่ƒฝ็ฎก็†ใ€Agent ็ฎก็†ใ€ๅ›ข้˜Ÿ็ผ–ๆŽ’ใ€MCP ๅฏผๅ‡บใ€TUI ไปช่กจ็›˜
  • v1.1 ๐Ÿ”œ โ€” ๅฏ่ง†ๅŒ– DAG ็ผ–่พ‘ๅ™จใ€ๆŠ€่ƒฝๅธ‚ๅœบใ€ๅ›ข้˜Ÿๆจกๆฟ
  • v1.2 ๐Ÿ”œ โ€” ๅˆ†ๅธƒๅผๆ‰ง่กŒๅผ•ๆ“Žใ€Web Dashboardใ€ๆ’ไปถ็ณป็ปŸ
  • v2.0 ๐Ÿ”ฎ โ€” ๅคšๆจกๆ€ๆŠ€่ƒฝๆ”ฏๆŒใ€AutoML ้›†ๆˆใ€ไผไธš็บงๆƒ้™็ฎก็†

๐Ÿ“ฆ ๅฎ‰่ฃ…ไธŽ้ƒจ็ฝฒๆŒ‡ๅ—

๐Ÿ ไปŽๆบ็ ๅฎ‰่ฃ…

git clone https://github.com/gitstq/AgentForge-Studio.git
cd AgentForge-Studio
pip install -e ".[tui]"

๐Ÿงช ๅผ€ๅ‘็Žฏๅขƒ

# ๅฎ‰่ฃ…ๅผ€ๅ‘ไพ่ต–
pip install -e ".[dev]"

# ่ฟ่กŒๆต‹่ฏ•
pytest

# ่ฟ่กŒๆต‹่ฏ•ๅนถ็”Ÿๆˆ่ฆ†็›–็އๆŠฅๅ‘Š
pytest --cov=agentforge

๐Ÿ“ ้กน็›ฎ็ป“ๆž„

AgentForge-Studio/
โ”œโ”€โ”€ agentforge/           # ๆ ธๅฟƒไปฃ็ 
โ”‚   โ”œโ”€โ”€ core/             # ๆ ธๅฟƒๆจกๅž‹๏ผˆSkill, Agent, Team, Engine๏ผ‰
โ”‚   โ”œโ”€โ”€ export/           # MCP ๅฏผๅ‡บๆจกๅ—
โ”‚   โ”œโ”€โ”€ sandbox/          # ๆต‹่ฏ•ๆฒ™็ฎฑ
โ”‚   โ”œโ”€โ”€ templates/        # ๅ†…็ฝฎๆจกๆฟ
โ”‚   โ”œโ”€โ”€ tui/              # TUI ไปช่กจ็›˜
โ”‚   โ”œโ”€โ”€ utils/            # ๅทฅๅ…ทๅ‡ฝๆ•ฐ
โ”‚   โ””โ”€โ”€ cli.py            # CLI ๅ…ฅๅฃ
โ”œโ”€โ”€ tests/                # ๅ•ๅ…ƒๆต‹่ฏ•๏ผˆ84 ไธช๏ผ‰
โ”œโ”€โ”€ pyproject.toml        # ้กน็›ฎ้…็ฝฎ
โ”œโ”€โ”€ requirements.txt      # ไพ่ต–ๅˆ—่กจ
โ””โ”€โ”€ LICENSE               # MIT ๅ่ฎฎ

๐Ÿค ่ดก็ŒฎๆŒ‡ๅ—

ๆˆ‘ไปฌๆฌข่ฟŽๅ„็งๅฝขๅผ็š„่ดก็Œฎ๏ผๆ— ่ฎบๆ˜ฏๆไบค Bugใ€ๆ”น่ฟ›ๆ–‡ๆกฃ๏ผŒ่ฟ˜ๆ˜ฏ่ดก็Œฎๆ–ฐๅŠŸ่ƒฝใ€‚

๐Ÿ“ ่ดก็Œฎๆต็จ‹

  1. Fork ๆœฌไป“ๅบ“
  2. ๅˆ›ๅปบ็‰นๆ€งๅˆ†ๆ”ฏ๏ผšgit checkout -b feature/amazing-feature
  3. ๆไบคๆ›ดๆ”น๏ผšgit commit -m 'Add some amazing feature'
  4. ๆŽจ้€ๅˆฐ่ฟœ็จ‹๏ผšgit push origin feature/amazing-feature
  5. ๆไบค Pull Request

๐Ÿ“‹ ๅผ€ๅ‘่ง„่Œƒ

  • ้ตๅพช PEP 8 ็ผ–็ ่ง„่Œƒ
  • ๆ‰€ๆœ‰ๆ–ฐๅŠŸ่ƒฝๅฟ…้กป้™„ๅธฆๅ•ๅ…ƒๆต‹่ฏ•
  • ๆไบคไฟกๆฏ้ตๅพช Conventional Commits ่ง„่Œƒ
  • ็กฎไฟๆ‰€ๆœ‰ๆต‹่ฏ•้€š่ฟ‡ๅŽๅ†ๆไบค PR

๐Ÿ“„ ๅผ€ๆบๅ่ฎฎ

ๆœฌ้กน็›ฎๅŸบไบŽ MIT License ๅผ€ๆบใ€‚

MIT License

Copyright (c) 2024 AgentForge Team

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

็”จ โค๏ธ ๆž„ๅปบ | AgentForge Studio


๐ŸŽ‰ AgentForge Studio

ๅœจ็ต‚็ซฏๆ‰“้€ ไฝ ็š„ AI Agent ่ปๅœ˜ โ€”โ€” ่ผ•้‡ใ€้ซ˜ๆ•ˆใ€้–‹็ฎฑๅณ็”จใ€‚

AgentForge Studio ๆ˜ฏไธ€ๅ€‹้‹่กŒๅœจ็ต‚็ซฏไธญ็š„ AI Agent ๆŠ€่ƒฝๅทฅๅป ่ˆ‡ๅœ˜้šŠ็ทจๆŽ’ๅผ•ๆ“Žใ€‚ๅฎƒ่ฎ“ไฝ ่ƒฝๅค ๅƒๆญ็ฉๆœจไธ€ๆจฃๅ‰ตๅปบใ€็ฎก็†ๅ’Œ็ทจๆŽ’ AI Agent ๆŠ€่ƒฝ๏ผŒไธฆ้€้Ž DAG ไพ่ณดๅœ–ๅฏฆ็พๅคš Agent ๅœ˜้šŠๅ”ไฝœใ€‚็„ก้œ€่ค‡้›œ้…็ฝฎ๏ผŒไธ€ๆขๅ‘ฝไปคๅณๅฏๅ•Ÿๅ‹•ไฝ ็š„ AI ๅทฅๅŠใ€‚

GitHub: https://github.com/gitstq/AgentForge-Studio


โœจ ๆ ธๅฟƒ็‰นๆ€ง

็‰นๆ€ง ่ชชๆ˜Ž
๐Ÿ› ๏ธ ๆŠ€่ƒฝ็ฎก็† ๅปบ็ซ‹ใ€็ทจ่ผฏใ€ๆธฌ่ฉฆใ€ๅŒฏๅ‡บ AI Agent ๆŠ€่ƒฝ๏ผŒๅฎŒๆ•ด็”Ÿๅ‘ฝ้€ฑๆœŸ็ฎก็†
๐Ÿค– Agent ็ฎก็† ๅปบ็ซ‹ Agent ไธฆ้ˆๆดปๅˆ†้…ๆŠ€่ƒฝ๏ผŒๆ‰“้€ ๅฐˆๅฑฌ AI ๅŠฉๆ‰‹
๐Ÿ”„ ๅœ˜้šŠ็ทจๆŽ’ ๅŸบๆ–ผ DAG ไพ่ณดๅœ–็ทจๆŽ’ๅคš Agent ๅœ˜้šŠๅ”ไฝœ๏ผŒๆ”ฏๆด่ฆ–่ฆบๅŒ–
๐Ÿ“‹ 20+ ๅ…งๅปบๆจกๆฟ ็จ‹ๅผ็ขผๅฏฉๆŸฅใ€ๆ–‡ไปถ็”Ÿๆˆใ€ๅฎ‰ๅ…จๆŽƒๆใ€่ณ‡ๆ–™ๅˆ†ๆž็ญ‰้–‹็ฎฑๅณ็”จ
๐Ÿ“ค MCP ๅŒฏๅ‡บ ๆŠ€่ƒฝไธ€้ตๅŒฏๅ‡บ็‚บ MCP Server ๆ ผๅผ๏ผŒ็„ก็ธซๅฐๆŽฅ LLM ็”Ÿๆ…‹
๐Ÿงช ๆธฌ่ฉฆๆฒ™็ฎฑ ็จ็ซ‹ๆธฌ่ฉฆๆฏๅ€‹ๆŠ€่ƒฝ๏ผŒ็ขบไฟๅ“่ณชๅฏ้ 
๐Ÿ“Š TUI ๅ„€่กจๆฟ Rich ็ต‚็ซฏไบ’ๅ‹•ไป‹้ข๏ผŒ่ณ‡่จŠไธ€็›ฎไบ†็„ถ
โœ… 84 ๅ€‹ๅ–ฎๅ…ƒๆธฌ่ฉฆ ๅ…จ้ƒจ้€š้Ž๏ผŒ็จ‹ๅผ็ขผๅ“่ณชๆœ‰ไฟ้šœ

๐Ÿš€ ๅฟซ้€Ÿ้–‹ๅง‹

๐Ÿ“‹ ็’ฐๅขƒ้œ€ๆฑ‚

  • Python 3.9 ๆˆ–ๆ›ด้ซ˜็‰ˆๆœฌ
  • pip ๅฅ—ไปถ็ฎก็†ๅ™จ
  • ็ต‚็ซฏ๏ผˆๅปบ่ญฐๆ”ฏๆด 256 ่‰ฒ็š„็ต‚็ซฏไปฅ็ฒๅพ—ๆœ€ไฝณ้ซ”้ฉ—๏ผ‰

๐Ÿ”ง ๅฎ‰่ฃๆญฅ้ฉŸ

# ่ค‡่ฃฝๅฐˆๆกˆ
git clone https://github.com/gitstq/AgentForge-Studio.git
cd AgentForge-Studio

# ๅฎ‰่ฃไพ่ณด
pip install -r requirements.txt

# ๅฎ‰่ฃๅฐˆๆกˆ๏ผˆๅฏ้ธ๏ผŒ่จปๅ†Š agentforge ๅ‘ฝไปค๏ผ‰
pip install -e .

๐ŸŽฎ ไฝฟ็”จๅ‘ฝไปค

# ๆŸฅ็œ‹็‰ˆๆœฌ
agentforge --version

# ๅˆๅง‹ๅŒ–ๅฐˆๆกˆ
agentforge init

# ๅ•Ÿๅ‹• TUI ๅ„€่กจๆฟ
agentforge dashboard

๐Ÿ“– ่ฉณ็ดฐไฝฟ็”จๆŒ‡ๅ—

๐Ÿ› ๏ธ ๆŠ€่ƒฝ็ฎก็†

ๆŠ€่ƒฝๆ˜ฏ AgentForge ็š„ๆ ธๅฟƒๅปบๆง‹ๅ–ฎๅ…ƒใ€‚ๆฏๅ€‹ๆŠ€่ƒฝๅฎš็พฉไบ† AI Agent ๅฏไปฅๅŸท่กŒ็š„ๅ…ท้ซ”่ƒฝๅŠ›ใ€‚

# ๅปบ็ซ‹ๆ–ฐๆŠ€่ƒฝ
agentforge skill create my-reviewer \
  --description "็จ‹ๅผ็ขผๅฏฉๆŸฅๅฐˆๅฎถ" \
  --instructions "ไฝ ๆ˜ฏไธ€ไฝ่ณ‡ๆทฑ็จ‹ๅผ็ขผๅฏฉๆŸฅๅฐˆๅฎถ๏ผŒ่ซ‹ไป”็ดฐๅฏฉๆŸฅ็จ‹ๅผ็ขผๅ“่ณช..."

# ๆŸฅ็œ‹ๆ‰€ๆœ‰ๆŠ€่ƒฝ
agentforge skill list

# ๆŸฅ็œ‹ๆŠ€่ƒฝ่ฉณๆƒ…
agentforge skill show my-reviewer

# ๆธฌ่ฉฆๆŠ€่ƒฝ
agentforge skill test my-reviewer

# ๅŒฏๅ‡บๆŠ€่ƒฝ็‚บ MCP ๆ ผๅผ
agentforge skill export my-reviewer --format mcp --output my-reviewer.json

๐Ÿค– Agent ็ฎก็†

Agent ๆ˜ฏๆŠ€่ƒฝ็š„่ผ‰้ซ”๏ผŒไฝ ๅฏไปฅ็‚บๆฏๅ€‹ Agent ๅˆ†้…ไธๅŒ็š„ๆŠ€่ƒฝ็ต„ๅˆใ€‚

# ๅปบ็ซ‹ Agent
agentforge agent create senior-dev \
  --role "้ซ˜็ดš้–‹็™ผๅทฅ็จ‹ๅธซ" \
  --system-prompt "ไฝ ๆ˜ฏไธ€ไฝ็ถ“้ฉ—่ฑๅฏŒ็š„้ซ˜็ดš้–‹็™ผๅทฅ็จ‹ๅธซ..." \
  --model gpt-4

# ๆŸฅ็œ‹ๆ‰€ๆœ‰ Agent
agentforge agent list

# ็‚บ Agent ๅˆ†้…ๆŠ€่ƒฝ
agentforge agent assign senior-dev my-reviewer

๐Ÿ”„ ๅœ˜้šŠ็ทจๆŽ’

้€้Ž DAG๏ผˆๆœ‰ๅ‘็„ก็’ฐๅœ–๏ผ‰ไพ่ณด้—œไฟ‚็ทจๆŽ’ๅคšๅ€‹ Agent ๅ”ๅŒๅทฅไฝœใ€‚

# ๅปบ็ซ‹ๅœ˜้šŠ
agentforge team create dev-team --description "้–‹็™ผๆตๆฐด็ทšๅœ˜้šŠ"

# ๆ–ฐๅขž Agent ๅˆฐๅœ˜้šŠ๏ผˆๆ”ฏๆดไพ่ณดๅฎฃๅ‘Š๏ผ‰
agentforge team add dev-team code-reviewer
agentforge team add dev-team bug-fixer --depends-on code-reviewer
agentforge team add dev-team test-gen --depends-on bug-fixer

# ่ฆ–่ฆบๅŒ–ๅœ˜้šŠ DAG ็ตๆง‹
agentforge team visualize dev-team

# ๅŸท่กŒๅœ˜้šŠ็ทจๆŽ’
agentforge team run dev-team

๐Ÿ“‹ ๆจกๆฟไฝฟ็”จ

AgentForge ๅ…งๅปบไบ† 20+ ๅ€‹็ฒพๅฟƒ่จญ่จˆ็š„ๆŠ€่ƒฝๆจกๆฟ๏ผŒๆถต่“‹้–‹็™ผๅ…จๆต็จ‹๏ผš

ๆจกๆฟๅ็จฑ ็”จ้€”
code-review ็จ‹ๅผ็ขผๅฏฉๆŸฅ๏ผŒๅตๆธฌ Bug ๅ’Œๅ“่ณชๅ•้กŒ
doc-generator ๅพžๅŽŸๅง‹็ขผๆˆ–ๆ่ฟฐ็”Ÿๆˆๆ–‡ไปถ
data-analyst ่ณ‡ๆ–™ๅˆ†ๆž่ˆ‡ๆดžๅฏŸ็”Ÿๆˆ
api-tester API ็ซฏ้ปžๆธฌ่ฉฆๆกˆไพ‹็”Ÿๆˆ
security-scanner ๅฎ‰ๅ…จๆผๆดžๆŽƒๆ๏ผˆOWASP Top 10๏ผ‰
code-refactorer ็จ‹ๅผ็ขผ้‡ๆง‹่ˆ‡ๆœ€ไฝณๅŒ–
translator ๅคš่ชž่จ€็ฟป่ญฏ
summarizer ๆ–‡ๅญ—ๆ‘˜่ฆ็”Ÿๆˆ
bug-fixer Bug ๅฎšไฝ่ˆ‡ไฟฎๅพฉ
perf-optimizer ๆ•ˆ่ƒฝๆœ€ไฝณๅŒ–ๅปบ่ญฐ
test-generator ๅ–ฎๅ…ƒๆธฌ่ฉฆ่ˆ‡ๆ•ดๅˆๆธฌ่ฉฆ็”Ÿๆˆ
code-explainer ็จ‹ๅผ็ขผ่งฃ้‡‹่ˆ‡่ชชๆ˜Ž
req-analyst ้œ€ๆฑ‚ๅˆ†ๆž่ˆ‡็ตๆง‹ๅŒ–
arch-designer ๆžถๆง‹่จญ่จˆ่ˆ‡ๆจกๅผๆŽจ่–ฆ
project-manager ๅฐˆๆกˆ่ฆๅŠƒ่ˆ‡็ฎก็†
code-migrator ่ทจ่ชž่จ€็จ‹ๅผ็ขผ้ท็งป
config-manager ่จญๅฎšๆช”็”Ÿๆˆ่ˆ‡็ฎก็†
log-analyst ๆ—ฅ่ชŒๅˆ†ๆž่ˆ‡ๆ•…้šœๆŽ’ๆŸฅ
deploy-helper ้ƒจ็ฝฒ่จญๅฎš่ˆ‡ CI/CD ็”Ÿๆˆ
monitor-analyst ็›ฃๆŽง่ˆ‡ๅฏ่ง€ๆธฌๆ€งๆ–นๆกˆ่จญ่จˆ
# ๆŸฅ็œ‹ๆ‰€ๆœ‰ๅฏ็”จๆจกๆฟ
agentforge template list

# ๅŸบๆ–ผๆจกๆฟๅปบ็ซ‹ๆŠ€่ƒฝ
agentforge template apply code-review my-custom-reviewer

๐Ÿ“ค ๅŒฏๅ‡บๅŠŸ่ƒฝ

ๅฐ‡ๆŠ€่ƒฝๅŒฏๅ‡บ็‚บๆจ™ๆบ– MCP Server ๆ ผๅผ๏ผŒ็„ก็ธซๆŽฅๅ…ฅ Claude Desktopใ€Cursor ็ญ‰ LLM ๅฎขๆˆถ็ซฏใ€‚

# ๅŒฏๅ‡บๅ–ฎไธ€ๆŠ€่ƒฝ
agentforge skill export my-skill --format mcp --output skill.json

# ๅŒฏๅ‡บๅพŒๅฏ็›ดๆŽฅ็”จๆ–ผ MCP ๅฎขๆˆถ็ซฏ่จญๅฎš

๐Ÿ’ก ่จญ่จˆๆ€่ทฏ่ˆ‡่ฟญไปฃ่ฆๅŠƒ

๐ŸŽฏ ่จญ่จˆ็†ๅฟต

AgentForge Studio ็š„ๆ ธๅฟƒ่จญ่จˆ็†ๅฟตๆ˜ฏ ใ€ŒๆŠ€่ƒฝๅณ็ฉๆœจ๏ผŒAgent ๅณๅทฅๅŒ ๏ผŒๅœ˜้šŠๅณๅทฅๅป ใ€๏ผš

  • ๆŠ€่ƒฝๅฑค๏ผˆSkill๏ผ‰๏ผšๅฎš็พฉๅŽŸๅญๅŒ–็š„ AI ่ƒฝๅŠ›ๅ–ฎๅ…ƒ๏ผŒๅŒ…ๅซๆŒ‡ไปคใ€ๅƒๆ•ธใ€่ผธๅ…ฅ่ผธๅ‡บ่ฆ็ฏ„
  • Agent ๅฑค๏ผšๅฐ‡ๆŠ€่ƒฝ็ต„ๅˆ่ณฆไบˆ็‰นๅฎš่ง’่‰ฒ๏ผŒๅฝขๆˆๅฐˆๆฅญๅŒ–็š„ AI ๅŠฉๆ‰‹
  • ๅœ˜้šŠๅฑค๏ผˆTeam๏ผ‰๏ผš้€้Ž DAG ไพ่ณดๅœ–็ทจๆŽ’ Agent ๅŸท่กŒ้ †ๅบ๏ผŒๅฏฆ็พ่ค‡้›œๅทฅไฝœๆต

๐Ÿ—บ๏ธ ่ฟญไปฃ่ฆๅŠƒ

  • v1.0 โœ… โ€” ๆ ธๅฟƒๅŠŸ่ƒฝ๏ผšๆŠ€่ƒฝ็ฎก็†ใ€Agent ็ฎก็†ใ€ๅœ˜้šŠ็ทจๆŽ’ใ€MCP ๅŒฏๅ‡บใ€TUI ๅ„€่กจๆฟ
  • v1.1 ๐Ÿ”œ โ€” ่ฆ–่ฆบๅŒ– DAG ็ทจ่ผฏๅ™จใ€ๆŠ€่ƒฝๅธ‚ๅ ดใ€ๅœ˜้šŠๆจกๆฟ
  • v1.2 ๐Ÿ”œ โ€” ๅˆ†ๆ•ฃๅผๅŸท่กŒๅผ•ๆ“Žใ€Web Dashboardใ€ๅค–ๆŽ›็ณป็ตฑ
  • v2.0 ๐Ÿ”ฎ โ€” ๅคšๆจกๆ…‹ๆŠ€่ƒฝๆ”ฏๆดใ€AutoML ๆ•ดๅˆใ€ไผๆฅญ็ดšๆฌŠ้™็ฎก็†

๐Ÿ“ฆ ๅฎ‰่ฃ่ˆ‡้ƒจ็ฝฒๆŒ‡ๅ—

๐Ÿ ๅพžๅŽŸๅง‹็ขผๅฎ‰่ฃ

git clone https://github.com/gitstq/AgentForge-Studio.git
cd AgentForge-Studio
pip install -e ".[tui]"

๐Ÿงช ้–‹็™ผ็’ฐๅขƒ

# ๅฎ‰่ฃ้–‹็™ผไพ่ณด
pip install -e ".[dev]"

# ๅŸท่กŒๆธฌ่ฉฆ
pytest

# ๅŸท่กŒๆธฌ่ฉฆไธฆ็”Ÿๆˆ่ฆ†่“‹็އๅ ฑๅ‘Š
pytest --cov=agentforge

๐Ÿ“ ๅฐˆๆกˆ็ตๆง‹

AgentForge-Studio/
โ”œโ”€โ”€ agentforge/           # ๆ ธๅฟƒ็จ‹ๅผ็ขผ
โ”‚   โ”œโ”€โ”€ core/             # ๆ ธๅฟƒๆจกๅž‹๏ผˆSkill, Agent, Team, Engine๏ผ‰
โ”‚   โ”œโ”€โ”€ export/           # MCP ๅŒฏๅ‡บๆจก็ต„
โ”‚   โ”œโ”€โ”€ sandbox/          # ๆธฌ่ฉฆๆฒ™็ฎฑ
โ”‚   โ”œโ”€โ”€ templates/        # ๅ…งๅปบๆจกๆฟ
โ”‚   โ”œโ”€โ”€ tui/              # TUI ๅ„€่กจๆฟ
โ”‚   โ”œโ”€โ”€ utils/            # ๅทฅๅ…ทๅ‡ฝๅผ
โ”‚   โ””โ”€โ”€ cli.py            # CLI ๅ…ฅๅฃ
โ”œโ”€โ”€ tests/                # ๅ–ฎๅ…ƒๆธฌ่ฉฆ๏ผˆ84 ๅ€‹๏ผ‰
โ”œโ”€โ”€ pyproject.toml        # ๅฐˆๆกˆ่จญๅฎš
โ”œโ”€โ”€ requirements.txt      # ไพ่ณดๆธ…ๅ–ฎ
โ””โ”€โ”€ LICENSE               # MIT ๆŽˆๆฌŠ

๐Ÿค ่ฒข็ปๆŒ‡ๅ—

ๆˆ‘ๅ€‘ๆญก่ฟŽๅ„็จฎๅฝขๅผ็š„่ฒข็ป๏ผ็„ก่ซ–ๆ˜ฏๆไบค Bugใ€ๆ”นๅ–„ๆ–‡ไปถ๏ผŒ้‚„ๆ˜ฏ่ฒข็ปๆ–ฐๅŠŸ่ƒฝใ€‚

๐Ÿ“ ่ฒข็ปๆต็จ‹

  1. Fork ๆœฌๅ€‰ๅบซ
  2. ๅปบ็ซ‹็‰นๆ€งๅˆ†ๆ”ฏ๏ผšgit checkout -b feature/amazing-feature
  3. ๆไบค่ฎŠๆ›ด๏ผšgit commit -m 'Add some amazing feature'
  4. ๆŽจ้€ๅˆฐ้ ็ซฏ๏ผšgit push origin feature/amazing-feature
  5. ๆไบค Pull Request

๐Ÿ“‹ ้–‹็™ผ่ฆ็ฏ„

  • ้ตๅพช PEP 8 ็ทจ็ขผ่ฆ็ฏ„
  • ๆ‰€ๆœ‰ๆ–ฐๅŠŸ่ƒฝๅฟ…้ ˆ้™„ๅธถๅ–ฎๅ…ƒๆธฌ่ฉฆ
  • ๆไบค่จŠๆฏ้ตๅพช Conventional Commits ่ฆ็ฏ„
  • ็ขบไฟๆ‰€ๆœ‰ๆธฌ่ฉฆ้€š้ŽๅพŒๅ†ๆไบค PR

๐Ÿ“„ ้–‹ๆบๅ”่ญฐ

ๆœฌๅฐˆๆกˆๅŸบๆ–ผ MIT License ้–‹ๆบใ€‚

MIT License

Copyright (c) 2024 AgentForge Team

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

็”จ โค๏ธ ๆ‰“้€  | AgentForge Studio


๐ŸŽ‰ AgentForge Studio

Build your AI Agent army right from the terminal โ€” lightweight, efficient, and ready to go.

AgentForge Studio is a terminal-based AI Agent skill factory and team orchestration engine. It empowers you to create, manage, and orchestrate AI Agent skills as easily as building blocks, and coordinate multi-Agent team collaboration through DAG dependency graphs. No complex setup needed โ€” launch your AI workshop with a single command.

GitHub: https://github.com/gitstq/AgentForge-Studio


โœจ Core Features

Feature Description
๐Ÿ› ๏ธ Skill Management Create, edit, test, and export AI Agent skills with full lifecycle management
๐Ÿค– Agent Management Create Agents and flexibly assign skills to build your custom AI assistants
๐Ÿ”„ Team Orchestration Orchestrate multi-Agent team collaboration via DAG dependency graphs with visualization
๐Ÿ“‹ 20+ Built-in Templates Code review, documentation generation, security scanning, data analysis, and more โ€” ready to use
๐Ÿ“ค MCP Export One-click export to MCP Server format for seamless integration with the LLM ecosystem
๐Ÿงช Test Sandbox Test each skill independently to ensure quality and reliability
๐Ÿ“Š TUI Dashboard Rich terminal interactive interface for a clear overview at a glance
โœ… 84 Unit Tests All passing โ€” code quality you can count on

๐Ÿš€ Quick Start

๐Ÿ“‹ Prerequisites

  • Python 3.9 or higher
  • pip package manager
  • A terminal (256-color support recommended for the best experience)

๐Ÿ”ง Installation

# Clone the repository
git clone https://github.com/gitstq/AgentForge-Studio.git
cd AgentForge-Studio

# Install dependencies
pip install -r requirements.txt

# Install the project (optional, registers the agentforge command)
pip install -e .

๐ŸŽฎ Usage

# Check version
agentforge --version

# Initialize a project
agentforge init

# Launch the TUI dashboard
agentforge dashboard

๐Ÿ“– Detailed Guide

๐Ÿ› ๏ธ Skill Management

Skills are the fundamental building blocks of AgentForge. Each skill defines a specific capability that an AI Agent can execute.

# Create a new skill
agentforge skill create my-reviewer \
  --description "Code review expert" \
  --instructions "You are a senior code reviewer, please carefully review code quality..."

# List all skills
agentforge skill list

# Show skill details
agentforge skill show my-reviewer

# Test a skill
agentforge skill test my-reviewer

# Export a skill to MCP format
agentforge skill export my-reviewer --format mcp --output my-reviewer.json

๐Ÿค– Agent Management

Agents are the carriers of skills. You can assign different skill combinations to each Agent.

# Create an Agent
agentforge agent create senior-dev \
  --role "Senior Developer" \
  --system-prompt "You are an experienced senior developer..." \
  --model gpt-4

# List all Agents
agentforge agent list

# Assign a skill to an Agent
agentforge agent assign senior-dev my-reviewer

๐Ÿ”„ Team Orchestration

Coordinate multiple Agents working together through DAG (Directed Acyclic Graph) dependency relationships.

# Create a team
agentforge team create dev-team --description "Development pipeline team"

# Add Agents to the team (with dependency declarations)
agentforge team add dev-team code-reviewer
agentforge team add dev-team bug-fixer --depends-on code-reviewer
agentforge team add dev-team test-gen --depends-on bug-fixer

# Visualize the team DAG structure
agentforge team visualize dev-team

# Execute team orchestration
agentforge team run dev-team

๐Ÿ“‹ Templates

AgentForge comes with 20+ carefully crafted skill templates covering the entire development lifecycle:

Template Purpose
code-review Code review โ€” detect bugs and quality issues
doc-generator Generate documentation from source code or descriptions
data-analyst Data analysis and insight generation
api-tester API endpoint test case generation
security-scanner Security vulnerability scanning (OWASP Top 10)
code-refactorer Code refactoring and optimization
translator Multi-language translation
summarizer Text summarization
bug-fixer Bug identification and fixing
perf-optimizer Performance optimization suggestions
test-generator Unit and integration test generation
code-explainer Code explanation and documentation
req-analyst Requirements analysis and structuring
arch-designer Architecture design and pattern recommendations
project-manager Project planning and management
code-migrator Cross-language code migration
config-manager Configuration file generation and management
log-analyst Log analysis and troubleshooting
deploy-helper Deployment configuration and CI/CD generation
monitor-analyst Monitoring and observability solution design
# List all available templates
agentforge template list

# Create a skill from a template
agentforge template apply code-review my-custom-reviewer

๐Ÿ“ค Export

Export skills to the standard MCP Server format for seamless integration with LLM clients like Claude Desktop and Cursor.

# Export a single skill
agentforge skill export my-skill --format mcp --output skill.json

# The exported file can be used directly in MCP client configuration

๐Ÿ’ก Design Philosophy & Roadmap

๐ŸŽฏ Design Philosophy

The core design philosophy of AgentForge Studio is "Skills as building blocks, Agents as craftsmen, Teams as factories":

  • Skill Layer: Defines atomic AI capability units with instructions, parameters, and I/O specifications
  • Agent Layer: Combines skills and assigns them to specific roles, creating specialized AI assistants
  • Team Layer: Orchestrates Agent execution order through DAG dependency graphs for complex workflows

๐Ÿ—บ๏ธ Roadmap

  • v1.0 โœ… โ€” Core features: skill management, Agent management, team orchestration, MCP export, TUI dashboard
  • v1.1 ๐Ÿ”œ โ€” Visual DAG editor, skill marketplace, team templates
  • v1.2 ๐Ÿ”œ โ€” Distributed execution engine, Web Dashboard, plugin system
  • v2.0 ๐Ÿ”ฎ โ€” Multi-modal skill support, AutoML integration, enterprise-grade permission management

๐Ÿ“ฆ Installation & Deployment

๐Ÿ Install from Source

git clone https://github.com/gitstq/AgentForge-Studio.git
cd AgentForge-Studio
pip install -e ".[tui]"

๐Ÿงช Development Setup

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run tests with coverage report
pytest --cov=agentforge

๐Ÿ“ Project Structure

AgentForge-Studio/
โ”œโ”€โ”€ agentforge/           # Core source code
โ”‚   โ”œโ”€โ”€ core/             # Core models (Skill, Agent, Team, Engine)
โ”‚   โ”œโ”€โ”€ export/           # MCP export module
โ”‚   โ”œโ”€โ”€ sandbox/          # Test sandbox
โ”‚   โ”œโ”€โ”€ templates/        # Built-in templates
โ”‚   โ”œโ”€โ”€ tui/              # TUI dashboard
โ”‚   โ”œโ”€โ”€ utils/            # Utility functions
โ”‚   โ””โ”€โ”€ cli.py            # CLI entry point
โ”œโ”€โ”€ tests/                # Unit tests (84 tests)
โ”œโ”€โ”€ pyproject.toml        # Project configuration
โ”œโ”€โ”€ requirements.txt      # Dependency list
โ””โ”€โ”€ LICENSE               # MIT License

๐Ÿค Contributing

We welcome contributions of all kinds! Whether it's filing a bug, improving documentation, or contributing new features.

๐Ÿ“ Contribution Workflow

  1. Fork this repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit your changes: git commit -m 'Add some amazing feature'
  4. Push to the remote: git push origin feature/amazing-feature
  5. Submit a Pull Request

๐Ÿ“‹ Development Standards

  • Follow PEP 8 coding conventions
  • All new features must include unit tests
  • Commit messages should follow the Conventional Commits specification
  • Ensure all tests pass before submitting a PR

๐Ÿ“„ License

This project is licensed under the MIT License.

MIT License

Copyright (c) 2024 AgentForge Team

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

Built with โค๏ธ | AgentForge Studio


๐ŸŽ‰ AgentForge Studio

ใ‚ฟใƒผใƒŸใƒŠใƒซใง AI Agent ่ปๅ›ฃใ‚’ๆง‹็ฏ‰ โ€”โ€” ่ปฝ้‡ใƒป้ซ˜ๆ•ˆใƒปใ™ใใซไฝฟใˆใพใ™ใ€‚

AgentForge Studio ใฏใ€ใ‚ฟใƒผใƒŸใƒŠใƒซไธŠใงๅ‹•ไฝœใ™ใ‚‹ AI Agent ใ‚นใ‚ญใƒซใƒ•ใ‚กใ‚ฏใƒˆใƒชใƒผ๏ผ†ใƒใƒผใƒ ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณใ‚จใƒณใ‚ธใƒณใงใ™ใ€‚ใƒ–ใƒญใƒƒใ‚ฏใ‚’็ต„ใฟ็ซ‹ใฆใ‚‹ใ‚ˆใ†ใซ AI Agent ใ‚นใ‚ญใƒซใ‚’ไฝœๆˆใƒป็ฎก็†ใƒปใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณใงใใ€DAG ไพๅญ˜้–ขไฟ‚ใ‚ฐใƒฉใƒ•ใ‚’้€šใ˜ใฆ่ค‡ๆ•ฐ Agent ใฎใƒใƒผใƒ ใ‚ณใƒฉใƒœใƒฌใƒผใ‚ทใƒงใƒณใ‚’ๅฎŸ็พใ—ใพใ™ใ€‚่ค‡้›‘ใช่จญๅฎšใฏไธ่ฆใ€ใ‚ณใƒžใƒณใƒ‰ไธ€ใคใง AI ใƒฏใƒผใ‚ฏใ‚ทใƒงใƒƒใƒ—ใ‚’ๅง‹ใ‚ใ‚‰ใ‚Œใพใ™ใ€‚

GitHub: https://github.com/gitstq/AgentForge-Studio


โœจ ไธปใชๆฉŸ่ƒฝ

ๆฉŸ่ƒฝ ่ชฌๆ˜Ž
๐Ÿ› ๏ธ ใ‚นใ‚ญใƒซ็ฎก็† AI Agent ใ‚นใ‚ญใƒซใฎไฝœๆˆใƒป็ทจ้›†ใƒปใƒ†ใ‚นใƒˆใƒปใ‚จใ‚ฏใ‚นใƒใƒผใƒˆใ€ใƒฉใ‚คใƒ•ใ‚ตใ‚คใ‚ฏใƒซๅ…จไฝ“ใ‚’็ฎก็†
๐Ÿค– Agent ็ฎก็† Agent ใ‚’ไฝœๆˆใ—ใ€ใ‚นใ‚ญใƒซใ‚’ๆŸ”่ปŸใซๅ‰ฒใ‚Šๅฝ“ใฆใฆๅฐ‚็”จ AI ใ‚ขใ‚ทใ‚นใ‚ฟใƒณใƒˆใ‚’ๆง‹็ฏ‰
๐Ÿ”„ ใƒใƒผใƒ ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณ DAG ไพๅญ˜้–ขไฟ‚ใ‚ฐใƒฉใƒ•ใง่ค‡ๆ•ฐ Agent ใฎใƒใƒผใƒ ใ‚ณใƒฉใƒœใƒฌใƒผใ‚ทใƒงใƒณใ‚’็ทจๆˆใ€ๅฏ่ฆ–ๅŒ–ๅฏพๅฟœ
๐Ÿ“‹ 20+ ็ต„ใฟ่พผใฟใƒ†ใƒณใƒ—ใƒฌใƒผใƒˆ ใ‚ณใƒผใƒ‰ใƒฌใƒ“ใƒฅใƒผใ€ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ็”Ÿๆˆใ€ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃใ‚นใ‚ญใƒฃใƒณใ€ใƒ‡ใƒผใ‚ฟๅˆ†ๆžใชใฉๅณๅบงใซๅˆฉ็”จๅฏ่ƒฝ
๐Ÿ“ค MCP ใ‚จใ‚ฏใ‚นใƒใƒผใƒˆ ใ‚นใ‚ญใƒซใ‚’ใƒฏใƒณใ‚ฏใƒชใƒƒใ‚ฏใง MCP Server ๅฝขๅผใซใ‚จใ‚ฏใ‚นใƒใƒผใƒˆใ€LLM ใ‚จใ‚ณใ‚ทใ‚นใƒ†ใƒ ใจใ‚ทใƒผใƒ ใƒฌใ‚น้€ฃๆบ
๐Ÿงช ใƒ†ใ‚นใƒˆใ‚ตใƒณใƒ‰ใƒœใƒƒใ‚ฏใ‚น ๅ„ใ‚นใ‚ญใƒซใ‚’็‹ฌ็ซ‹ใ—ใฆใƒ†ใ‚นใƒˆใ€ๅ“่ณชใจไฟก้ ผๆ€งใ‚’็ขบไฟ
๐Ÿ“Š TUI ใƒ€ใƒƒใ‚ทใƒฅใƒœใƒผใƒ‰ Rich ใ‚ฟใƒผใƒŸใƒŠใƒซใ‚คใƒณใ‚ฟใƒฉใ‚ฏใƒ†ใ‚ฃใƒ–ใ‚คใƒณใ‚ฟใƒผใƒ•ใ‚งใƒผใ‚นใงๆƒ…ๅ ฑใ‚’ไธ€็›ฎใงๆŠŠๆก
โœ… 84 ใฎใƒฆใƒ‹ใƒƒใƒˆใƒ†ใ‚นใƒˆ ๅ…จใฆๅˆๆ ผใ€ใ‚ณใƒผใƒ‰ๅ“่ณชใ‚’ไฟ่จผ

๐Ÿš€ ใ‚ฏใ‚คใƒƒใ‚ฏใ‚นใ‚ฟใƒผใƒˆ

๐Ÿ“‹ ๅ‹•ไฝœ็’ฐๅขƒ

  • Python 3.9 ไปฅไธŠ
  • pip ใƒ‘ใƒƒใ‚ฑใƒผใ‚ธใƒžใƒใƒผใ‚ธใƒฃใƒผ
  • ใ‚ฟใƒผใƒŸใƒŠใƒซ๏ผˆ256่‰ฒๅฏพๅฟœใ‚’ๆŽจๅฅจใ€ๆœ€้ฉใชไฝ“้จ“ใ‚’ๆไพ›๏ผ‰

๐Ÿ”ง ใ‚คใƒณใ‚นใƒˆใƒผใƒซๆ‰‹้ †

# ใƒชใƒใ‚ธใƒˆใƒชใ‚’ใ‚ฏใƒญใƒผใƒณ
git clone https://github.com/gitstq/AgentForge-Studio.git
cd AgentForge-Studio

# ไพๅญ˜้–ขไฟ‚ใ‚’ใ‚คใƒณใ‚นใƒˆใƒผใƒซ
pip install -r requirements.txt

# ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใ‚’ใ‚คใƒณใ‚นใƒˆใƒผใƒซ๏ผˆไปปๆ„ใ€agentforge ใ‚ณใƒžใƒณใƒ‰ใ‚’็™ป้Œฒ๏ผ‰
pip install -e .

๐ŸŽฎ ๅŸบๆœฌ็š„ใชไฝฟใ„ๆ–น

# ใƒใƒผใ‚ธใƒงใƒณ็ขบ่ช
agentforge --version

# ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใ‚’ๅˆๆœŸๅŒ–
agentforge init

# TUI ใƒ€ใƒƒใ‚ทใƒฅใƒœใƒผใƒ‰ใ‚’่ตทๅ‹•
agentforge dashboard

๐Ÿ“– ่ฉณ็ดฐใ‚ฌใ‚คใƒ‰

๐Ÿ› ๏ธ ใ‚นใ‚ญใƒซ็ฎก็†

ใ‚นใ‚ญใƒซใฏ AgentForge ใฎๅŸบๆœฌๆง‹ๆˆๅ˜ไฝใงใ™ใ€‚ๅ„ใ‚นใ‚ญใƒซใฏ AI Agent ใŒๅฎŸ่กŒใงใใ‚‹ๅ…ทไฝ“็š„ใช่ƒฝๅŠ›ใ‚’ๅฎš็พฉใ—ใพใ™ใ€‚

# ๆ–ฐใ—ใ„ใ‚นใ‚ญใƒซใ‚’ไฝœๆˆ
agentforge skill create my-reviewer \
  --description "ใ‚ณใƒผใƒ‰ใƒฌใƒ“ใƒฅใƒผๅฐ‚้–€ๅฎถ" \
  --instructions "ใ‚ใชใŸใฏใ‚ทใƒ‹ใ‚ขใ‚ณใƒผใƒ‰ใƒฌใƒ“ใƒฅใ‚ขใƒผใงใ™ใ€‚ใ‚ณใƒผใƒ‰ใฎๅ“่ณชใ‚’ๆณจๆ„ๆทฑใใƒฌใƒ“ใƒฅใƒผใ—ใฆใใ ใ•ใ„..."

# ๅ…จใ‚นใ‚ญใƒซใ‚’ไธ€่ฆง่กจ็คบ
agentforge skill list

# ใ‚นใ‚ญใƒซใฎ่ฉณ็ดฐใ‚’่กจ็คบ
agentforge skill show my-reviewer

# ใ‚นใ‚ญใƒซใ‚’ใƒ†ใ‚นใƒˆ
agentforge skill test my-reviewer

# ใ‚นใ‚ญใƒซใ‚’ MCP ๅฝขๅผใงใ‚จใ‚ฏใ‚นใƒใƒผใƒˆ
agentforge skill export my-reviewer --format mcp --output my-reviewer.json

๐Ÿค– Agent ็ฎก็†

Agent ใฏใ‚นใ‚ญใƒซใฎๆ‹…ใ„ๆ‰‹ใงใ™ใ€‚ๅ„ Agent ใซ็•ฐใชใ‚‹ใ‚นใ‚ญใƒซใฎ็ต„ใฟๅˆใ‚ใ›ใ‚’ๅ‰ฒใ‚Šๅฝ“ใฆใ‚‹ใ“ใจใŒใงใใพใ™ใ€‚

# Agent ใ‚’ไฝœๆˆ
agentforge agent create senior-dev \
  --role "ใ‚ทใƒ‹ใ‚ข้–‹็™บ่€…" \
  --system-prompt "ใ‚ใชใŸใฏ็ตŒ้จ“่ฑŠๅฏŒใชใ‚ทใƒ‹ใ‚ข้–‹็™บ่€…ใงใ™..." \
  --model gpt-4

# ๅ…จ Agent ใ‚’ไธ€่ฆง่กจ็คบ
agentforge agent list

# Agent ใซใ‚นใ‚ญใƒซใ‚’ๅ‰ฒใ‚Šๅฝ“ใฆ
agentforge agent assign senior-dev my-reviewer

๐Ÿ”„ ใƒใƒผใƒ ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณ

DAG๏ผˆๆœ‰ๅ‘้žๅทกๅ›žใ‚ฐใƒฉใƒ•๏ผ‰ใฎไพๅญ˜้–ขไฟ‚ใ‚’้€šใ˜ใฆใ€่ค‡ๆ•ฐ Agent ใฎ้€ฃๆบใ‚’็ทจๆˆใ—ใพใ™ใ€‚

# ใƒใƒผใƒ ใ‚’ไฝœๆˆ
agentforge team create dev-team --description "้–‹็™บใƒ‘ใ‚คใƒ—ใƒฉใ‚คใƒณใƒใƒผใƒ "

# Agent ใ‚’ใƒใƒผใƒ ใซ่ฟฝๅŠ ๏ผˆไพๅญ˜้–ขไฟ‚ใฎๅฎฃ่จ€ใซๅฏพๅฟœ๏ผ‰
agentforge team add dev-team code-reviewer
agentforge team add dev-team bug-fixer --depends-on code-reviewer
agentforge team add dev-team test-gen --depends-on bug-fixer

# ใƒใƒผใƒ ใฎ DAG ๆง‹้€ ใ‚’ๅฏ่ฆ–ๅŒ–
agentforge team visualize dev-team

# ใƒใƒผใƒ ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณใ‚’ๅฎŸ่กŒ
agentforge team run dev-team

๐Ÿ“‹ ใƒ†ใƒณใƒ—ใƒฌใƒผใƒˆใฎๅˆฉ็”จ

AgentForge ใซใฏ 20 ไปฅไธŠใฎๆ…Ž้‡ใซ่จญ่จˆใ•ใ‚ŒใŸใ‚นใ‚ญใƒซใƒ†ใƒณใƒ—ใƒฌใƒผใƒˆใŒ็ต„ใฟ่พผใพใ‚ŒใฆใŠใ‚Šใ€้–‹็™บใƒฉใ‚คใƒ•ใ‚ตใ‚คใ‚ฏใƒซๅ…จไฝ“ใ‚’ใ‚ซใƒใƒผใ—ใฆใ„ใพใ™๏ผš

ใƒ†ใƒณใƒ—ใƒฌใƒผใƒˆ ็”จ้€”
code-review ใ‚ณใƒผใƒ‰ใƒฌใƒ“ใƒฅใƒผใ€ใƒใ‚ฐใจๅ“่ณชๅ•้กŒใฎๆคœๅ‡บ
doc-generator ใ‚ฝใƒผใ‚นใ‚ณใƒผใƒ‰ใ‚„่ชฌๆ˜Žใ‹ใ‚‰ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆใ‚’็”Ÿๆˆ
data-analyst ใƒ‡ใƒผใ‚ฟๅˆ†ๆžใจใ‚คใƒณใ‚ตใ‚คใƒˆ็”Ÿๆˆ
api-tester API ใ‚จใƒณใƒ‰ใƒใ‚คใƒณใƒˆใฎใƒ†ใ‚นใƒˆใ‚ฑใƒผใ‚น็”Ÿๆˆ
security-scanner ใ‚ปใ‚ญใƒฅใƒชใƒ†ใ‚ฃ่„†ๅผฑๆ€งใ‚นใ‚ญใƒฃใƒณ๏ผˆOWASP Top 10๏ผ‰
code-refactorer ใ‚ณใƒผใƒ‰ใƒชใƒ•ใ‚กใ‚ฏใ‚ฟใƒชใƒณใ‚ฐใจๆœ€้ฉๅŒ–
translator ๅคš่จ€่ชž็ฟป่จณ
summarizer ใƒ†ใ‚ญใ‚นใƒˆ่ฆ็ด„็”Ÿๆˆ
bug-fixer ใƒใ‚ฐใฎ็‰นๅฎšใจไฟฎๆญฃ
perf-optimizer ใƒ‘ใƒ•ใ‚ฉใƒผใƒžใƒณใ‚นๆœ€้ฉๅŒ–ใฎๆๆกˆ
test-generator ใƒฆใƒ‹ใƒƒใƒˆใƒ†ใ‚นใƒˆใจ็ตฑๅˆใƒ†ใ‚นใƒˆใฎ็”Ÿๆˆ
code-explainer ใ‚ณใƒผใƒ‰ใฎ่งฃ่ชฌใจ่ชฌๆ˜Ž
req-analyst ่ฆไปถๅˆ†ๆžใจๆง‹้€ ๅŒ–
arch-designer ใ‚ขใƒผใ‚ญใƒ†ใ‚ฏใƒใƒฃ่จญ่จˆใจใƒ‘ใ‚ฟใƒผใƒณใฎๆŽจๅฅจ
project-manager ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆ่จˆ็”ปใจ็ฎก็†
code-migrator ่จ€่ชž้–“ใฎใ‚ณใƒผใƒ‰็งป่กŒ
config-manager ่จญๅฎšใƒ•ใ‚กใ‚คใƒซใฎ็”Ÿๆˆใจ็ฎก็†
log-analyst ใƒญใ‚ฐๅˆ†ๆžใจใƒˆใƒฉใƒ–ใƒซใ‚ทใƒฅใƒผใƒ†ใ‚ฃใƒณใ‚ฐ
deploy-helper ใƒ‡ใƒ—ใƒญใ‚ค่จญๅฎšใจ CI/CD ็”Ÿๆˆ
monitor-analyst ็›ฃ่ฆ–ใจใ‚ชใƒ–ใ‚ถใƒผใƒใƒ“ใƒชใƒ†ใ‚ฃใฎ่จญ่จˆ
# ๅˆฉ็”จๅฏ่ƒฝใชใƒ†ใƒณใƒ—ใƒฌใƒผใƒˆใ‚’ไธ€่ฆง่กจ็คบ
agentforge template list

# ใƒ†ใƒณใƒ—ใƒฌใƒผใƒˆใ‹ใ‚‰ใ‚นใ‚ญใƒซใ‚’ไฝœๆˆ
agentforge template apply code-review my-custom-reviewer

๐Ÿ“ค ใ‚จใ‚ฏใ‚นใƒใƒผใƒˆๆฉŸ่ƒฝ

ใ‚นใ‚ญใƒซใ‚’ๆจ™ๆบ– MCP Server ๅฝขๅผใซใ‚จใ‚ฏใ‚นใƒใƒผใƒˆใ—ใ€Claude Desktop ใ‚„ Cursor ใชใฉใฎ LLM ใ‚ฏใƒฉใ‚คใ‚ขใƒณใƒˆใจใ‚ทใƒผใƒ ใƒฌใ‚นใซ้€ฃๆบใงใใพใ™ใ€‚

# ๅ˜ไธ€ใ‚นใ‚ญใƒซใ‚’ใ‚จใ‚ฏใ‚นใƒใƒผใƒˆ
agentforge skill export my-skill --format mcp --output skill.json

# ใ‚จใ‚ฏใ‚นใƒใƒผใƒˆๅพŒใฏ MCP ใ‚ฏใƒฉใ‚คใ‚ขใƒณใƒˆ่จญๅฎšใง็›ดๆŽฅๅˆฉ็”จๅฏ่ƒฝ

๐Ÿ’ก ่จญ่จˆๆ€ๆƒณใจใƒญใƒผใƒ‰ใƒžใƒƒใƒ—

๐ŸŽฏ ่จญ่จˆๆ€ๆƒณ

AgentForge Studio ใฎไธญๆ ธใจใชใ‚‹่จญ่จˆๆ€ๆƒณใฏ ใ€Œใ‚นใ‚ญใƒซใฏใƒ–ใƒญใƒƒใ‚ฏใ€Agent ใฏ่ทไบบใ€ใƒใƒผใƒ ใฏๅทฅๅ ดใ€ ใงใ™๏ผš

  • ใ‚นใ‚ญใƒซๅฑค๏ผˆSkill๏ผ‰๏ผšๅ‘ฝไปคใ€ใƒ‘ใƒฉใƒกใƒผใ‚ฟใ€ๅ…ฅๅ‡บๅŠ›ไป•ๆง˜ใ‚’ๅซใ‚€ใ‚ขใƒˆใƒŸใƒƒใ‚ฏใช AI ่ƒฝๅŠ›ใƒฆใƒ‹ใƒƒใƒˆใ‚’ๅฎš็พฉ
  • Agent ๅฑค๏ผšใ‚นใ‚ญใƒซใ‚’็ต„ใฟๅˆใ‚ใ›ใฆ็‰นๅฎšใฎๅฝนๅ‰ฒใซๅ‰ฒใ‚Šๅฝ“ใฆใ€ๅฐ‚้–€็š„ใช AI ใ‚ขใ‚ทใ‚นใ‚ฟใƒณใƒˆใ‚’ๅฝขๆˆ
  • ใƒใƒผใƒ ๅฑค๏ผˆTeam๏ผ‰๏ผšDAG ไพๅญ˜้–ขไฟ‚ใ‚ฐใƒฉใƒ•ใง Agent ใฎๅฎŸ่กŒ้ †ๅบใ‚’็ทจๆˆใ—ใ€่ค‡้›‘ใชใƒฏใƒผใ‚ฏใƒ•ใƒญใƒผใ‚’ๅฎŸ็พ

๐Ÿ—บ๏ธ ใƒญใƒผใƒ‰ใƒžใƒƒใƒ—

  • v1.0 โœ… โ€” ใ‚ณใ‚ขๆฉŸ่ƒฝ๏ผšใ‚นใ‚ญใƒซ็ฎก็†ใ€Agent ็ฎก็†ใ€ใƒใƒผใƒ ใ‚ชใƒผใ‚ฑใ‚นใƒˆใƒฌใƒผใ‚ทใƒงใƒณใ€MCP ใ‚จใ‚ฏใ‚นใƒใƒผใƒˆใ€TUI ใƒ€ใƒƒใ‚ทใƒฅใƒœใƒผใƒ‰
  • v1.1 ๐Ÿ”œ โ€” ใƒ“ใ‚ธใƒฅใ‚ขใƒซ DAG ใ‚จใƒ‡ใ‚ฃใ‚ฟใ€ใ‚นใ‚ญใƒซใƒžใƒผใ‚ฑใƒƒใƒˆใƒ—ใƒฌใ‚คใ‚นใ€ใƒใƒผใƒ ใƒ†ใƒณใƒ—ใƒฌใƒผใƒˆ
  • v1.2 ๐Ÿ”œ โ€” ๅˆ†ๆ•ฃๅฎŸ่กŒใ‚จใƒณใ‚ธใƒณใ€Web ใƒ€ใƒƒใ‚ทใƒฅใƒœใƒผใƒ‰ใ€ใƒ—ใƒฉใ‚ฐใ‚คใƒณใ‚ทใ‚นใƒ†ใƒ 
  • v2.0 ๐Ÿ”ฎ โ€” ใƒžใƒซใƒใƒขใƒผใƒ€ใƒซใ‚นใ‚ญใƒซๅฏพๅฟœใ€AutoML ็ตฑๅˆใ€ใ‚จใƒณใ‚ฟใƒผใƒ—ใƒฉใ‚คใ‚บ็ดšๆจฉ้™็ฎก็†

๐Ÿ“ฆ ใ‚คใƒณใ‚นใƒˆใƒผใƒซใจใƒ‡ใƒ—ใƒญใ‚ค

๐Ÿ ใ‚ฝใƒผใ‚นใ‹ใ‚‰ใ‚คใƒณใ‚นใƒˆใƒผใƒซ

git clone https://github.com/gitstq/AgentForge-Studio.git
cd AgentForge-Studio
pip install -e ".[tui]"

๐Ÿงช ้–‹็™บ็’ฐๅขƒใฎใ‚ปใƒƒใƒˆใ‚ขใƒƒใƒ—

# ้–‹็™บ็”จไพๅญ˜้–ขไฟ‚ใ‚’ใ‚คใƒณใ‚นใƒˆใƒผใƒซ
pip install -e ".[dev]"

# ใƒ†ใ‚นใƒˆใ‚’ๅฎŸ่กŒ
pytest

# ใ‚ซใƒใƒฌใƒƒใ‚ธใƒฌใƒใƒผใƒˆไป˜ใใงใƒ†ใ‚นใƒˆใ‚’ๅฎŸ่กŒ
pytest --cov=agentforge

๐Ÿ“ ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆๆง‹ๆˆ

AgentForge-Studio/
โ”œโ”€โ”€ agentforge/           # ใ‚ณใ‚ขใ‚ฝใƒผใ‚นใ‚ณใƒผใƒ‰
โ”‚   โ”œโ”€โ”€ core/             # ใ‚ณใ‚ขใƒขใƒ‡ใƒซ๏ผˆSkill, Agent, Team, Engine๏ผ‰
โ”‚   โ”œโ”€โ”€ export/           # MCP ใ‚จใ‚ฏใ‚นใƒใƒผใƒˆใƒขใ‚ธใƒฅใƒผใƒซ
โ”‚   โ”œโ”€โ”€ sandbox/          # ใƒ†ใ‚นใƒˆใ‚ตใƒณใƒ‰ใƒœใƒƒใ‚ฏใ‚น
โ”‚   โ”œโ”€โ”€ templates/        # ็ต„ใฟ่พผใฟใƒ†ใƒณใƒ—ใƒฌใƒผใƒˆ
โ”‚   โ”œโ”€โ”€ tui/              # TUI ใƒ€ใƒƒใ‚ทใƒฅใƒœใƒผใƒ‰
โ”‚   โ”œโ”€โ”€ utils/            # ใƒฆใƒผใƒ†ใ‚ฃใƒชใƒ†ใ‚ฃ้–ขๆ•ฐ
โ”‚   โ””โ”€โ”€ cli.py            # CLI ใ‚จใƒณใƒˆใƒชใƒผใƒใ‚คใƒณใƒˆ
โ”œโ”€โ”€ tests/                # ใƒฆใƒ‹ใƒƒใƒˆใƒ†ใ‚นใƒˆ๏ผˆ84 ใƒ†ใ‚นใƒˆ๏ผ‰
โ”œโ”€โ”€ pyproject.toml        # ใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆ่จญๅฎš
โ”œโ”€โ”€ requirements.txt      # ไพๅญ˜้–ขไฟ‚ใƒชใ‚นใƒˆ
โ””โ”€โ”€ LICENSE               # MIT ใƒฉใ‚คใ‚ปใƒณใ‚น

๐Ÿค ใ‚ณใƒณใƒˆใƒชใƒ“ใƒฅใƒผใ‚ทใƒงใƒณ

ใ‚ใ‚‰ใ‚†ใ‚‹ๅฝขใฎใ‚ณใƒณใƒˆใƒชใƒ“ใƒฅใƒผใ‚ทใƒงใƒณใ‚’ๆญ“่ฟŽใ—ใพใ™๏ผใƒใ‚ฐๅ ฑๅ‘Šใ€ใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆๆ”นๅ–„ใ€ๆ–ฐๆฉŸ่ƒฝใฎๆไพ›ใชใฉใ€ใฉใฎใ‚ˆใ†ใช่ฒข็Œฎใงใ‚‚ๅคงๆญ“่ฟŽใงใ™ใ€‚

๐Ÿ“ ใ‚ณใƒณใƒˆใƒชใƒ“ใƒฅใƒผใ‚ทใƒงใƒณใƒ•ใƒญใƒผ

  1. ใƒชใƒใ‚ธใƒˆใƒชใ‚’ Fork ใ™ใ‚‹
  2. ใƒ•ใ‚ฃใƒผใƒใƒฃใƒผใƒ–ใƒฉใƒณใƒใ‚’ไฝœๆˆ๏ผšgit checkout -b feature/amazing-feature
  3. ๅค‰ๆ›ดใ‚’ใ‚ณใƒŸใƒƒใƒˆ๏ผšgit commit -m 'Add some amazing feature'
  4. ใƒชใƒขใƒผใƒˆใซใƒ—ใƒƒใ‚ทใƒฅ๏ผšgit push origin feature/amazing-feature
  5. Pull Request ใ‚’ๆๅ‡บใ™ใ‚‹

๐Ÿ“‹ ้–‹็™บ่ฆ็ฏ„

  • PEP 8 ใ‚ณใƒผใƒ‡ใ‚ฃใƒณใ‚ฐ่ฆ็ด„ใซๅพ“ใ†ใ“ใจ
  • ๆ–ฐๆฉŸ่ƒฝใซใฏๅฟ…ใšใƒฆใƒ‹ใƒƒใƒˆใƒ†ใ‚นใƒˆใ‚’ๅซใ‚ใ‚‹ใ“ใจ
  • ใ‚ณใƒŸใƒƒใƒˆใƒกใƒƒใ‚ปใƒผใ‚ธใฏ Conventional Commits ไป•ๆง˜ใซๅพ“ใ†ใ“ใจ
  • PR ใ‚’ๆๅ‡บๅ‰ใซๅ…จใƒ†ใ‚นใƒˆใŒ้€š้Žใ™ใ‚‹ใ“ใจใ‚’็ขบ่ชใ™ใ‚‹ใ“ใจ

๐Ÿ“„ ใƒฉใ‚คใ‚ปใƒณใ‚น

ใ“ใฎใƒ—ใƒญใ‚ธใ‚งใ‚ฏใƒˆใฏ MIT License ใฎไธ‹ใงใ‚ชใƒผใƒ—ใƒณใ‚ฝใƒผใ‚นใจใ—ใฆๅ…ฌ้–‹ใ•ใ‚Œใฆใ„ใพใ™ใ€‚

MIT License

Copyright (c) 2024 AgentForge Team

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

โค๏ธ ใงๆง‹็ฏ‰ | AgentForge Studio


๐ŸŽ‰ AgentForge Studio

ํ„ฐ๋ฏธ๋„์—์„œ AI Agent ๊ตฐ๋‹จ์„ ๊ตฌ์ถ•ํ•˜์„ธ์š” โ€” ๊ฐ€๋ณ๊ณ , ํšจ์œจ์ ์ด๋ฉฐ, ๋ฐ”๋กœ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

AgentForge Studio๋Š” ํ„ฐ๋ฏธ๋„ ๊ธฐ๋ฐ˜์˜ AI Agent ์Šคํ‚ฌ ํŒฉํ† ๋ฆฌ ๋ฐ ํŒ€ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ ์—”์ง„์ž…๋‹ˆ๋‹ค. ๋ธ”๋ก์„ ์กฐ๋ฆฝํ•˜๋“ฏ AI Agent ์Šคํ‚ฌ์„ ๋งŒ๋“ค๊ณ , ๊ด€๋ฆฌํ•˜๊ณ , ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ํ•  ์ˆ˜ ์žˆ์œผ๋ฉฐ, DAG ์˜์กด์„ฑ ๊ทธ๋ž˜ํ”„๋ฅผ ํ†ตํ•ด ๋‹ค์ค‘ Agent ํŒ€ ํ˜‘์—…์„ ๊ตฌํ˜„ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋ณต์žกํ•œ ์„ค์ • ์—†์ด ๋ช…๋ น์–ด ํ•˜๋‚˜๋กœ AI ์›Œํฌ์ˆ์„ ์‹œ์ž‘ํ•˜์„ธ์š”.

GitHub: https://github.com/gitstq/AgentForge-Studio


โœจ ํ•ต์‹ฌ ๊ธฐ๋Šฅ

๊ธฐ๋Šฅ ์„ค๋ช…
๐Ÿ› ๏ธ ์Šคํ‚ฌ ๊ด€๋ฆฌ AI Agent ์Šคํ‚ฌ ์ƒ์„ฑ, ํŽธ์ง‘, ํ…Œ์ŠคํŠธ, ๋‚ด๋ณด๋‚ด๊ธฐ โ€” ์ „์ฒด ์ˆ˜๋ช… ์ฃผ๊ธฐ ๊ด€๋ฆฌ
๐Ÿค– Agent ๊ด€๋ฆฌ Agent ์ƒ์„ฑ ๋ฐ ์Šคํ‚ฌ ์œ ์—ฐํ•œ ํ• ๋‹น์œผ๋กœ ๋งž์ถคํ˜• AI ์–ด์‹œ์Šคํ„ดํŠธ ๊ตฌ์ถ•
๐Ÿ”„ ํŒ€ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ DAG ์˜์กด์„ฑ ๊ทธ๋ž˜ํ”„ ๊ธฐ๋ฐ˜ ๋‹ค์ค‘ Agent ํŒ€ ํ˜‘์—… ํŽธ์„ฑ, ์‹œ๊ฐํ™” ์ง€์›
๐Ÿ“‹ 20+ ๋‚ด์žฅ ํ…œํ”Œ๋ฆฟ ์ฝ”๋“œ ๋ฆฌ๋ทฐ, ๋ฌธ์„œ ์ƒ์„ฑ, ๋ณด์•ˆ ์Šค์บ”, ๋ฐ์ดํ„ฐ ๋ถ„์„ ๋“ฑ ์ฆ‰์‹œ ์‚ฌ์šฉ ๊ฐ€๋Šฅ
๐Ÿ“ค MCP ๋‚ด๋ณด๋‚ด๊ธฐ ์Šคํ‚ฌ์„ ์›ํด๋ฆญ์œผ๋กœ MCP Server ํ˜•์‹์œผ๋กœ ๋‚ด๋ณด๋‚ด๊ธฐ, LLM ์ƒํƒœ๊ณ„์™€ ์›ํ™œํ•œ ์—ฐ๋™
๐Ÿงช ํ…Œ์ŠคํŠธ ์ƒŒ๋“œ๋ฐ•์Šค ๊ฐ ์Šคํ‚ฌ์„ ๋…๋ฆฝ์ ์œผ๋กœ ํ…Œ์ŠคํŠธํ•˜์—ฌ ํ’ˆ์งˆ๊ณผ ์‹ ๋ขฐ์„ฑ ๋ณด์žฅ
๐Ÿ“Š TUI ๋Œ€์‹œ๋ณด๋“œ Rich ํ„ฐ๋ฏธ๋„ ์ธํ„ฐ๋ž™ํ‹ฐ๋ธŒ ์ธํ„ฐํŽ˜์ด์Šค๋กœ ์ •๋ณด๋ฅผ ํ•œ๋ˆˆ์— ํŒŒ์•…
โœ… 84๊ฐœ ๋‹จ์œ„ ํ…Œ์ŠคํŠธ ์ „์ฒด ํ†ต๊ณผ, ์ฝ”๋“œ ํ’ˆ์งˆ ๋ณด์žฅ

๐Ÿš€ ๋น ๋ฅธ ์‹œ์ž‘

๐Ÿ“‹ ์‚ฌ์ „ ์š”๊ตฌ ์‚ฌํ•ญ

  • Python 3.9 ์ด์ƒ
  • pip ํŒจํ‚ค์ง€ ๊ด€๋ฆฌ์ž
  • ํ„ฐ๋ฏธ๋„ (256์ƒ‰ ์ง€์› ๊ถŒ์žฅ, ์ตœ์ƒ์˜ ๊ฒฝํ—˜์„ ์œ„ํ•ด)

๐Ÿ”ง ์„ค์น˜ ๋ฐฉ๋ฒ•

# ์ €์žฅ์†Œ ๋ณต์ œ
git clone https://github.com/gitstq/AgentForge-Studio.git
cd AgentForge-Studio

# ์˜์กด์„ฑ ์„ค์น˜
pip install -r requirements.txt

# ํ”„๋กœ์ ํŠธ ์„ค์น˜ (์„ ํƒ ์‚ฌํ•ญ, agentforge ๋ช…๋ น์–ด ๋“ฑ๋ก)
pip install -e .

๐ŸŽฎ ์‚ฌ์šฉ๋ฒ•

# ๋ฒ„์ „ ํ™•์ธ
agentforge --version

# ํ”„๋กœ์ ํŠธ ์ดˆ๊ธฐํ™”
agentforge init

# TUI ๋Œ€์‹œ๋ณด๋“œ ์‹คํ–‰
agentforge dashboard

๐Ÿ“– ์ƒ์„ธ ๊ฐ€์ด๋“œ

๐Ÿ› ๏ธ ์Šคํ‚ฌ ๊ด€๋ฆฌ

์Šคํ‚ฌ์€ AgentForge์˜ ๊ธฐ๋ณธ ๊ตฌ์„ฑ ๋‹จ์œ„์ž…๋‹ˆ๋‹ค. ๊ฐ ์Šคํ‚ฌ์€ AI Agent๊ฐ€ ์‹คํ–‰ํ•  ์ˆ˜ ์žˆ๋Š” ๊ตฌ์ฒด์ ์ธ ๋Šฅ๋ ฅ์„ ์ •์˜ํ•ฉ๋‹ˆ๋‹ค.

# ์ƒˆ ์Šคํ‚ฌ ์ƒ์„ฑ
agentforge skill create my-reviewer \
  --description "์ฝ”๋“œ ๋ฆฌ๋ทฐ ์ „๋ฌธ๊ฐ€" \
  --instructions "๋‹น์‹ ์€ ์‹œ๋‹ˆ์–ด ์ฝ”๋“œ ๋ฆฌ๋ทฐ์–ด์ž…๋‹ˆ๋‹ค. ์ฝ”๋“œ ํ’ˆ์งˆ์„ ๊ผผ๊ผผํ•˜๊ฒŒ ๊ฒ€ํ† ํ•ด ์ฃผ์„ธ์š”..."

# ์ „์ฒด ์Šคํ‚ฌ ๋ชฉ๋ก ๋ณด๊ธฐ
agentforge skill list

# ์Šคํ‚ฌ ์ƒ์„ธ ์ •๋ณด ๋ณด๊ธฐ
agentforge skill show my-reviewer

# ์Šคํ‚ฌ ํ…Œ์ŠคํŠธ
agentforge skill test my-reviewer

# ์Šคํ‚ฌ์„ MCP ํ˜•์‹์œผ๋กœ ๋‚ด๋ณด๋‚ด๊ธฐ
agentforge skill export my-reviewer --format mcp --output my-reviewer.json

๐Ÿค– Agent ๊ด€๋ฆฌ

Agent๋Š” ์Šคํ‚ฌ์˜ ์šด๋ฐ˜์ฒด์ž…๋‹ˆ๋‹ค. ๊ฐ Agent์— ๋‹ค์–‘ํ•œ ์Šคํ‚ฌ ์กฐํ•ฉ์„ ํ• ๋‹นํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

# Agent ์ƒ์„ฑ
agentforge agent create senior-dev \
  --role "์‹œ๋‹ˆ์–ด ๊ฐœ๋ฐœ์ž" \
  --system-prompt "๋‹น์‹ ์€ ๊ฒฝํ—˜์ด ํ’๋ถ€ํ•œ ์‹œ๋‹ˆ์–ด ๊ฐœ๋ฐœ์ž์ž…๋‹ˆ๋‹ค..." \
  --model gpt-4

# ์ „์ฒด Agent ๋ชฉ๋ก ๋ณด๊ธฐ
agentforge agent list

# Agent์— ์Šคํ‚ฌ ํ• ๋‹น
agentforge agent assign senior-dev my-reviewer

๐Ÿ”„ ํŒ€ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜

DAG (์œ ํ–ฅ ๋น„์ˆœํ™˜ ๊ทธ๋ž˜ํ”„) ์˜์กด์„ฑ ๊ด€๊ณ„๋ฅผ ํ†ตํ•ด ์—ฌ๋Ÿฌ Agent์˜ ํ˜‘์—…์„ ํŽธ์„ฑํ•ฉ๋‹ˆ๋‹ค.

# ํŒ€ ์ƒ์„ฑ
agentforge team create dev-team --description "๊ฐœ๋ฐœ ํŒŒ์ดํ”„๋ผ์ธ ํŒ€"

# ํŒ€์— Agent ์ถ”๊ฐ€ (์˜์กด์„ฑ ์„ ์–ธ ์ง€์›)
agentforge team add dev-team code-reviewer
agentforge team add dev-team bug-fixer --depends-on code-reviewer
agentforge team add dev-team test-gen --depends-on bug-fixer

# ํŒ€ DAG ๊ตฌ์กฐ ์‹œ๊ฐํ™”
agentforge team visualize dev-team

# ํŒ€ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ ์‹คํ–‰
agentforge team run dev-team

๐Ÿ“‹ ํ…œํ”Œ๋ฆฟ ํ™œ์šฉ

AgentForge์—๋Š” ๊ฐœ๋ฐœ ๋ผ์ดํ”„์‚ฌ์ดํด ์ „์ฒด๋ฅผ ์•„์šฐ๋ฅด๋Š” 20๊ฐœ ์ด์ƒ์˜ ์ •๊ตํ•˜๊ฒŒ ์„ค๊ณ„๋œ ์Šคํ‚ฌ ํ…œํ”Œ๋ฆฟ์ด ๋‚ด์žฅ๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹ค:

ํ…œํ”Œ๋ฆฟ ์šฉ๋„
code-review ์ฝ”๋“œ ๋ฆฌ๋ทฐ, ๋ฒ„๊ทธ ๋ฐ ํ’ˆ์งˆ ๋ฌธ์ œ ๊ฐ์ง€
doc-generator ์†Œ์Šค ์ฝ”๋“œ๋‚˜ ์„ค๋ช…์—์„œ ๋ฌธ์„œ ์ƒ์„ฑ
data-analyst ๋ฐ์ดํ„ฐ ๋ถ„์„ ๋ฐ ์ธ์‚ฌ์ดํŠธ ์ƒ์„ฑ
api-tester API ์—”๋“œํฌ์ธํŠธ ํ…Œ์ŠคํŠธ ์ผ€์ด์Šค ์ƒ์„ฑ
security-scanner ๋ณด์•ˆ ์ทจ์•ฝ์  ์Šค์บ” (OWASP Top 10)
code-refactorer ์ฝ”๋“œ ๋ฆฌํŒฉํ† ๋ง ๋ฐ ์ตœ์ ํ™”
translator ๋‹ค๊ตญ์–ด ๋ฒˆ์—ญ
summarizer ํ…์ŠคํŠธ ์š”์•ฝ ์ƒ์„ฑ
bug-fixer ๋ฒ„๊ทธ ์‹๋ณ„ ๋ฐ ์ˆ˜์ •
perf-optimizer ์„ฑ๋Šฅ ์ตœ์ ํ™” ์ œ์•ˆ
test-generator ๋‹จ์œ„ ํ…Œ์ŠคํŠธ ๋ฐ ํ†ตํ•ฉ ํ…Œ์ŠคํŠธ ์ƒ์„ฑ
code-explainer ์ฝ”๋“œ ์„ค๋ช… ๋ฐ ํ•ด์„ค
req-analyst ์š”๊ตฌ์‚ฌํ•ญ ๋ถ„์„ ๋ฐ ๊ตฌ์กฐํ™”
arch-designer ์•„ํ‚คํ…์ฒ˜ ์„ค๊ณ„ ๋ฐ ํŒจํ„ด ์ถ”์ฒœ
project-manager ํ”„๋กœ์ ํŠธ ๊ธฐํš ๋ฐ ๊ด€๋ฆฌ
code-migrator ์–ธ์–ด ๊ฐ„ ์ฝ”๋“œ ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜
config-manager ์„ค์ • ํŒŒ์ผ ์ƒ์„ฑ ๋ฐ ๊ด€๋ฆฌ
log-analyst ๋กœ๊ทธ ๋ถ„์„ ๋ฐ ๋ฌธ์ œ ํ•ด๊ฒฐ
deploy-helper ๋ฐฐํฌ ์„ค์ • ๋ฐ CI/CD ์ƒ์„ฑ
monitor-analyst ๋ชจ๋‹ˆํ„ฐ๋ง ๋ฐ ๊ด€์ธก ๊ฐ€๋Šฅ์„ฑ ์„ค๊ณ„
# ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ํ…œํ”Œ๋ฆฟ ๋ชฉ๋ก ๋ณด๊ธฐ
agentforge template list

# ํ…œํ”Œ๋ฆฟ์—์„œ ์Šคํ‚ฌ ์ƒ์„ฑ
agentforge template apply code-review my-custom-reviewer

๐Ÿ“ค ๋‚ด๋ณด๋‚ด๊ธฐ ๊ธฐ๋Šฅ

์Šคํ‚ฌ์„ ํ‘œ์ค€ MCP Server ํ˜•์‹์œผ๋กœ ๋‚ด๋ณด๋‚ด์–ด Claude Desktop, Cursor ๋“ฑ LLM ํด๋ผ์ด์–ธํŠธ์™€ ์›ํ™œํ•˜๊ฒŒ ์—ฐ๋™ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

# ๋‹จ์ผ ์Šคํ‚ฌ ๋‚ด๋ณด๋‚ด๊ธฐ
agentforge skill export my-skill --format mcp --output skill.json

# ๋‚ด๋ณด๋‚ธ ํŒŒ์ผ์€ MCP ํด๋ผ์ด์–ธํŠธ ์„ค์ •์—์„œ ์ง์ ‘ ์‚ฌ์šฉ ๊ฐ€๋Šฅ

๐Ÿ’ก ์„ค๊ณ„ ์ฒ ํ•™๊ณผ ๋กœ๋“œ๋งต

๐ŸŽฏ ์„ค๊ณ„ ์ฒ ํ•™

AgentForge Studio์˜ ํ•ต์‹ฌ ์„ค๊ณ„ ์ฒ ํ•™์€ "์Šคํ‚ฌ์€ ๋ธ”๋ก, Agent๋Š” ์žฅ์ธ, ํŒ€์€ ๊ณต์žฅ" ์ž…๋‹ˆ๋‹ค:

  • ์Šคํ‚ฌ ๋ ˆ์ด์–ด: ๋ช…๋ น์–ด, ํŒŒ๋ผ๋ฏธํ„ฐ, ์ž…์ถœ๋ ฅ ์‚ฌ์–‘์„ ํฌํ•จํ•˜๋Š” ์›์ž์  AI ๋Šฅ๋ ฅ ๋‹จ์œ„๋ฅผ ์ •์˜
  • Agent ๋ ˆ์ด์–ด: ์Šคํ‚ฌ์„ ์กฐํ•ฉํ•˜์—ฌ ํŠน์ • ์—ญํ• ์— ํ• ๋‹นํ•˜๊ณ , ์ „๋ฌธํ™”๋œ AI ์–ด์‹œ์Šคํ„ดํŠธ๋ฅผ ํ˜•์„ฑ
  • ํŒ€ ๋ ˆ์ด์–ด: DAG ์˜์กด์„ฑ ๊ทธ๋ž˜ํ”„๋กœ Agent ์‹คํ–‰ ์ˆœ์„œ๋ฅผ ํŽธ์„ฑํ•˜์—ฌ ๋ณต์žกํ•œ ์›Œํฌํ”Œ๋กœ์šฐ๋ฅผ ๊ตฌํ˜„

๐Ÿ—บ๏ธ ๋กœ๋“œ๋งต

  • v1.0 โœ… โ€” ํ•ต์‹ฌ ๊ธฐ๋Šฅ: ์Šคํ‚ฌ ๊ด€๋ฆฌ, Agent ๊ด€๋ฆฌ, ํŒ€ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜, MCP ๋‚ด๋ณด๋‚ด๊ธฐ, TUI ๋Œ€์‹œ๋ณด๋“œ
  • v1.1 ๐Ÿ”œ โ€” ์‹œ๊ฐ์  DAG ํŽธ์ง‘๊ธฐ, ์Šคํ‚ฌ ๋งˆ์ผ“ํ”Œ๋ ˆ์ด์Šค, ํŒ€ ํ…œํ”Œ๋ฆฟ
  • v1.2 ๐Ÿ”œ โ€” ๋ถ„์‚ฐ ์‹คํ–‰ ์—”์ง„, Web ๋Œ€์‹œ๋ณด๋“œ, ํ”Œ๋Ÿฌ๊ทธ์ธ ์‹œ์Šคํ…œ
  • v2.0 ๐Ÿ”ฎ โ€” ๋ฉ€ํ‹ฐ๋ชจ๋‹ฌ ์Šคํ‚ฌ ์ง€์›, AutoML ํ†ตํ•ฉ, ์—”ํ„ฐํ”„๋ผ์ด์ฆˆ๊ธ‰ ๊ถŒํ•œ ๊ด€๋ฆฌ

๐Ÿ“ฆ ์„ค์น˜ ๋ฐ ๋ฐฐํฌ

๐Ÿ ์†Œ์Šค์—์„œ ์„ค์น˜

git clone https://github.com/gitstq/AgentForge-Studio.git
cd AgentForge-Studio
pip install -e ".[tui]"

๐Ÿงช ๊ฐœ๋ฐœ ํ™˜๊ฒฝ ์„ค์ •

# ๊ฐœ๋ฐœ์šฉ ์˜์กด์„ฑ ์„ค์น˜
pip install -e ".[dev]"

# ํ…Œ์ŠคํŠธ ์‹คํ–‰
pytest

# ์ปค๋ฒ„๋ฆฌ์ง€ ๋ฆฌํฌํŠธ์™€ ํ•จ๊ป˜ ํ…Œ์ŠคํŠธ ์‹คํ–‰
pytest --cov=agentforge

๐Ÿ“ ํ”„๋กœ์ ํŠธ ๊ตฌ์กฐ

AgentForge-Studio/
โ”œโ”€โ”€ agentforge/           # ํ•ต์‹ฌ ์†Œ์Šค ์ฝ”๋“œ
โ”‚   โ”œโ”€โ”€ core/             # ํ•ต์‹ฌ ๋ชจ๋ธ (Skill, Agent, Team, Engine)
โ”‚   โ”œโ”€โ”€ export/           # MCP ๋‚ด๋ณด๋‚ด๊ธฐ ๋ชจ๋“ˆ
โ”‚   โ”œโ”€โ”€ sandbox/          # ํ…Œ์ŠคํŠธ ์ƒŒ๋“œ๋ฐ•์Šค
โ”‚   โ”œโ”€โ”€ templates/        # ๋‚ด์žฅ ํ…œํ”Œ๋ฆฟ
โ”‚   โ”œโ”€โ”€ tui/              # TUI ๋Œ€์‹œ๋ณด๋“œ
โ”‚   โ”œโ”€โ”€ utils/            # ์œ ํ‹ธ๋ฆฌํ‹ฐ ํ•จ์ˆ˜
โ”‚   โ””โ”€โ”€ cli.py            # CLI ์ง„์ž…์ 
โ”œโ”€โ”€ tests/                # ๋‹จ์œ„ ํ…Œ์ŠคํŠธ (84๊ฐœ)
โ”œโ”€โ”€ pyproject.toml        # ํ”„๋กœ์ ํŠธ ์„ค์ •
โ”œโ”€โ”€ requirements.txt      # ์˜์กด์„ฑ ๋ชฉ๋ก
โ””โ”€โ”€ LICENSE               # MIT ๋ผ์ด์„ ์Šค

๐Ÿค ๊ธฐ์—ฌํ•˜๊ธฐ

๋ชจ๋“  ํ˜•ํƒœ์˜ ๊ธฐ์—ฌ๋ฅผ ํ™˜์˜ํ•ฉ๋‹ˆ๋‹ค! ๋ฒ„๊ทธ ์ œ๋ณด, ๋ฌธ์„œ ๊ฐœ์„ , ์ƒˆ๋กœ์šด ๊ธฐ๋Šฅ ์ œ๊ณต ๋“ฑ ์–ด๋–ค ๊ธฐ์—ฌ๋“  ํ™˜์˜ํ•ฉ๋‹ˆ๋‹ค.

๐Ÿ“ ๊ธฐ์—ฌ ์ ˆ์ฐจ

  1. ์ €์žฅ์†Œ๋ฅผ Fork ํ•ฉ๋‹ˆ๋‹ค
  2. ๊ธฐ๋Šฅ ๋ธŒ๋žœ์น˜ ์ƒ์„ฑ: git checkout -b feature/amazing-feature
  3. ๋ณ€๊ฒฝ ์‚ฌํ•ญ ์ปค๋ฐ‹: git commit -m 'Add some amazing feature'
  4. ์›๊ฒฉ์— ํ‘ธ์‹œ: git push origin feature/amazing-feature
  5. Pull Request ์ œ์ถœ

๐Ÿ“‹ ๊ฐœ๋ฐœ ๊ทœ๋ฒ”

  • PEP 8 ์ฝ”๋”ฉ ๊ทœ์น™์„ ๋”ฐ๋ฅผ ๊ฒƒ
  • ๋ชจ๋“  ์ƒˆ ๊ธฐ๋Šฅ์—๋Š” ๋‹จ์œ„ ํ…Œ์ŠคํŠธ๋ฅผ ํฌํ•จํ•  ๊ฒƒ
  • ์ปค๋ฐ‹ ๋ฉ”์‹œ์ง€๋Š” Conventional Commits ์‚ฌ์–‘์„ ๋”ฐ๋ฅผ ๊ฒƒ
  • PR ์ œ์ถœ ์ „ ๋ชจ๋“  ํ…Œ์ŠคํŠธ๊ฐ€ ํ†ต๊ณผํ•˜๋Š”์ง€ ํ™•์ธํ•  ๊ฒƒ

๐Ÿ“„ ๋ผ์ด์„ ์Šค

์ด ํ”„๋กœ์ ํŠธ๋Š” MIT License์— ๋”ฐ๋ผ ์˜คํ”ˆ์†Œ์Šค๋กœ ๊ณต๊ฐœ๋ฉ๋‹ˆ๋‹ค.

MIT License

Copyright (c) 2024 AgentForge Team

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

โค๏ธ๋กœ ์ œ์ž‘ | AgentForge Studio


๐ŸŽ‰ AgentForge Studio

Construye tu ejercito de AI Agent desde la terminal โ€” ligero, eficiente y listo para usar.

AgentForge Studio es una fabrica de habilidades y un motor de orquestacion de equipos de AI Agent basado en terminal. Te permite crear, gestionar y orquestar habilidades de AI Agent con la misma facilidad que armar bloques, y coordinar la colaboracion de multiples Agent mediante grafos de dependencia DAG. Sin configuraciones complejas: con un solo comando puedes poner en marcha tu taller de IA.

GitHub: https://github.com/gitstq/AgentForge-Studio


โœจ Caracteristicas Principales

Caracteristica Descripcion
๐Ÿ› ๏ธ Gestion de Habilidades Crear, editar, probar y exportar habilidades de AI Agent con gestion completa del ciclo de vida
๐Ÿค– Gestion de Agentes Crear Agentes y asignar habilidades de forma flexible para construir asistentes de IA personalizados
๐Ÿ”„ Orquestacion de Equipos Orquestar la colaboracion de multiples Agentes mediante grafos de dependencia DAG con visualizacion
๐Ÿ“‹ 20+ Plantillas Integradas Revision de codigo, generacion de documentacion, analisis de seguridad, analisis de datos y mas, listas para usar
๐Ÿ“ค Exportacion MCP Exportacion con un clic al formato MCP Server para integracion perfecta con el ecosistema LLM
๐Ÿงช SandBox de Pruebas Probar cada habilidad de forma independiente para garantizar calidad y fiabilidad
๐Ÿ“Š Panel TUI Interfaz interactiva de terminal con Rich para una vision clara de un vistazo
โœ… 84 Tests Unitarios Todos aprobados, calidad de codigo garantizada

๐Ÿš€ Inicio Rapido

๐Ÿ“‹ Requisitos Previos

  • Python 3.9 o superior
  • Gestor de paquetes pip
  • Terminal (se recomienda soporte de 256 colores para la mejor experiencia)

๐Ÿ”ง Instalacion

# Clonar el repositorio
git clone https://github.com/gitstq/AgentForge-Studio.git
cd AgentForge-Studio

# Instalar dependencias
pip install -r requirements.txt

# Instalar el proyecto (opcional, registra el comando agentforge)
pip install -e .

๐ŸŽฎ Uso Basico

# Verificar la version
agentforge --version

# Inicializar un proyecto
agentforge init

# Iniciar el panel TUI
agentforge dashboard

๐Ÿ“– Guia Detallada

๐Ÿ› ๏ธ Gestion de Habilidades

Las habilidades son las unidades fundamentales de AgentForge. Cada habilidad define una capacidad especifica que un AI Agent puede ejecutar.

# Crear una nueva habilidad
agentforge skill create my-reviewer \
  --description "Experto en revision de codigo" \
  --instructions "Eres un revisor de codigo senior. Por favor, revisa cuidadosamente la calidad del codigo..."

# Listar todas las habilidades
agentforge skill list

# Ver detalles de una habilidad
agentforge skill show my-reviewer

# Probar una habilidad
agentforge skill test my-reviewer

# Exportar una habilidad en formato MCP
agentforge skill export my-reviewer --format mcp --output my-reviewer.json

๐Ÿค– Gestion de Agentes

Los Agentes son los portadores de habilidades. Puedes asignar diferentes combinaciones de habilidades a cada Agente.

# Crear un Agente
agentforge agent create senior-dev \
  --role "Desarrollador Senior" \
  --system-prompt "Eres un desarrollador senior con amplia experiencia..." \
  --model gpt-4

# Listar todos los Agentes
agentforge agent list

# Asignar una habilidad a un Agente
agentforge agent assign senior-dev my-reviewer

๐Ÿ”„ Orquestacion de Equipos

Coordina la colaboracion de multiples Agentes mediante relaciones de dependencia DAG (Grafo Dirigido Aciclico).

# Crear un equipo
agentforge team create dev-team --description "Equipo de pipeline de desarrollo"

# Anadir Agentes al equipo (con declaracion de dependencias)
agentforge team add dev-team code-reviewer
agentforge team add dev-team bug-fixer --depends-on code-reviewer
agentforge team add dev-team test-gen --depends-on bug-fixer

# Visualizar la estructura DAG del equipo
agentforge team visualize dev-team

# Ejecutar la orquestacion del equipo
agentforge team run dev-team

๐Ÿ“‹ Uso de Plantillas

AgentForge incluye mas de 20 plantillas de habilidades cuidadosamente disenadas que cubren todo el ciclo de desarrollo:

Plantilla Proposito
code-review Revision de codigo, deteccion de bugs y problemas de calidad
doc-generator Generacion de documentacion a partir de codigo fuente o descripciones
data-analyst Analisis de datos y generacion de insights
api-tester Generacion de casos de prueba para endpoints de API
security-scanner Escaneo de vulnerabilidades de seguridad (OWASP Top 10)
code-refactorer Refactorizacion y optimizacion de codigo
translator Traduccion a multiples idiomas
summarizer Generacion de resumenes de texto
bug-fixer Identificacion y correccion de bugs
perf-optimizer Sugerencias de optimizacion de rendimiento
test-generator Generacion de tests unitarios y de integracion
code-explainer Explicacion y documentacion de codigo
req-analyst Analisis y estructuracion de requisitos
arch-designer Diseno de arquitectura y recomendacion de patrones
project-manager Planificacion y gestion de proyectos
code-migrator Migracion de codigo entre lenguajes
config-manager Generacion y gestion de archivos de configuracion
log-analyst Analisis de logs y resolucion de problemas
deploy-helper Configuracion de despliegue y generacion de CI/CD
monitor-analyst Diseno de monitorizacion y observabilidad
# Listar todas las plantillas disponibles
agentforge template list

# Crear una habilidad a partir de una plantilla
agentforge template apply code-review my-custom-reviewer

๐Ÿ“ค Funcionalidad de Exportacion

Exporta habilidades al formato estandar MCP Server para una integracion perfecta con clientes LLM como Claude Desktop y Cursor.

# Exportar una habilidad individual
agentforge skill export my-skill --format mcp --output skill.json

# El archivo exportado se puede usar directamente en la configuracion del cliente MCP

๐Ÿ’ก Filosofia de Diseno y Hoja de Ruta

๐ŸŽฏ Filosofia de Diseno

La filosofia de diseno central de AgentForge Studio es "Las habilidades son bloques, los Agentes son artesanos, los equipos son fabricas":

  • Capa de Habilidades (Skill): Define unidades atomicas de capacidad de IA con instrucciones, parametros y especificaciones de entrada/salida
  • Capa de Agentes: Combina habilidades y las asigna a roles especificos, creando asistentes de IA especializados
  • Capa de Equipos: Orquesta el orden de ejecucion de los Agentes mediante grafos de dependencia DAG para flujos de trabajo complejos

๐Ÿ—บ๏ธ Hoja de Ruta

  • v1.0 โœ… โ€” Funciones principales: gestion de habilidades, gestion de Agentes, orquestacion de equipos, exportacion MCP, panel TUI
  • v1.1 ๐Ÿ”œ โ€” Editor DAG visual, mercado de habilidades, plantillas de equipos
  • v1.2 ๐Ÿ”œ โ€” Motor de ejecucion distribuido, panel Web, sistema de plugins
  • v2.0 ๐Ÿ”ฎ โ€” Soporte de habilidades multimodales, integracion con AutoML, gestion de permisos a nivel empresarial

๐Ÿ“ฆ Instalacion y Despliegue

๐Ÿ Instalacion desde el Fuente

git clone https://github.com/gitstq/AgentForge-Studio.git
cd AgentForge-Studio
pip install -e ".[tui]"

๐Ÿงช Configuracion del Entorno de Desarrollo

# Instalar dependencias de desarrollo
pip install -e ".[dev]"

# Ejecutar tests
pytest

# Ejecutar tests con informe de cobertura
pytest --cov=agentforge

๐Ÿ“ Estructura del Proyecto

AgentForge-Studio/
โ”œโ”€โ”€ agentforge/           # Codigo fuente principal
โ”‚   โ”œโ”€โ”€ core/             # Modelos principales (Skill, Agent, Team, Engine)
โ”‚   โ”œโ”€โ”€ export/           # Modulo de exportacion MCP
โ”‚   โ”œโ”€โ”€ sandbox/          # SandBox de pruebas
โ”‚   โ”œโ”€โ”€ templates/        # Plantillas integradas
โ”‚   โ”œโ”€โ”€ tui/              # Panel TUI
โ”‚   โ”œโ”€โ”€ utils/            # Funciones de utilidad
โ”‚   โ””โ”€โ”€ cli.py            # Punto de entrada CLI
โ”œโ”€โ”€ tests/                # Tests unitarios (84 tests)
โ”œโ”€โ”€ pyproject.toml        # Configuracion del proyecto
โ”œโ”€โ”€ requirements.txt      # Lista de dependencias
โ””โ”€โ”€ LICENSE               # Licencia MIT

๐Ÿค Contribuir

ยกAgradecemos todo tipo de contribuciones! Ya sea informar de un bug, mejorar la documentacion o aportar nuevas funcionalidades.

๐Ÿ“ Flujo de Contribucion

  1. Fork este repositorio
  2. Crear una rama de funcionalidad: git checkout -b feature/amazing-feature
  3. Confirmar los cambios: git commit -m 'Add some amazing feature'
  4. Enviar al remoto: git push origin feature/amazing-feature
  5. Enviar un Pull Request

๐Ÿ“‹ Normas de Desarrollo

  • Seguir las convenciones de codificacion PEP 8
  • Todas las nuevas funcionalidades deben incluir tests unitarios
  • Los mensajes de commit deben seguir la especificacion Conventional Commits
  • Asegurarse de que todos los tests pasen antes de enviar un PR

๐Ÿ“„ Licencia

Este proyecto se publica como codigo abierto bajo la MIT License.

MIT License

Copyright (c) 2024 AgentForge Team

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

Hecho con โค๏ธ | AgentForge Studio

About

๐Ÿฆž AgentForge-Studio - Lightweight Terminal AI Agent Skill Factory & Team Orchestration Engine | ่ฝป้‡็บง็ปˆ็ซฏAI AgentๆŠ€่ƒฝๅทฅๅŽ‚ไธŽๅ›ข้˜Ÿ็ผ–ๆŽ’ๅผ•ๆ“Ž

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages