Octopai - Engine de Skills com Evolução Contínua
Yuan-ManX/octopai
Transforme recursos em skills evolucionários para agentes IA
Ver no GitHubPlataforma de skills para agentes IA que transforma qualquer recurso (URLs, PDFs, vídeos, código) em competências estruturadas e reutilizáveis. Implementa evolução contínua de skills através de feedback inteligente, versionamento e otimização automática, com rastreamento de performance em tempo real.
Instalação
npx convez-ai Yuan-ManX/octopai1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Criar skills reutilizáveis a partir de documentação e URLs
- Evoluir e otimizar automaticamente competências de agentes IA
- Rastrear performance e custos de skills em produção
- Construir repositório versionado de conhecimento estruturado
Veredito

Octopai é uma solução ambiciosa para gestão de skills em agentes IA com recursos sofisticados como Feedback Descent e OctoTrace. Recomendado para equipes que precisam escalar competências de agentes com versionamento e otimização contínua, mas requer expertise técnica considerável para implementação.
README
A tradução para o português deste README ainda está na fila.
English | 中文文档
Overview
Octopai is a revolutionary AI Agent Skills Exploration, Extension, and Evolution Intelligence Engine built on a powerful core principle: Everything can be a Skill • Skills evolve through continuous learning • Elevating AI Agent cognition.
Transform any resource—web pages, documents, videos, code, datasets, and more—into structured, reusable Skill content. Through intelligent learning and continuous self-evolution, Skills grow and improve over time.
Core Philosophy
Mission: Explore, Extend, Evolve AI Agent Cognition
- Explore vast knowledge on the internet and various file formats
- Extend AI Agent capabilities through structured, reusable skills
- Evolve skills through intelligent reflection and optimization
Principles: Everything can be a Skill, Skills evolve through learning
- Everything can be a Skill: Transform any resource into structured, AI-ready Skills
- Skills evolve through learning: Every Skill continuously learns from usage, feedback, and interactions, growing more powerful over time
✨ Key Features
🔧 Skill Creator
Create skills from any resource:
- One-click URL conversion: Transform URLs into structured Markdown
- Multi-format parser: PDF, DOC, XLSX, PPTX, images, videos, etc.
- Skill templates: Pre-built templates for quick creation
- Quality evaluation: Intelligent quality scoring and optimization
🚀 Skill Evolution
Advanced Feedback Descent algorithm:
- Frontier management: Maintain top-performing skill variants
- Selection strategies: Best, round-robin, weighted, random
- Evolution modes: Skill-only, prompt-only, hybrid
- Real-time tracing: OctoTrace performance monitoring
🏪 Skills Hub
Comprehensive skill management center:
- Skill repository: Organize, search, and manage skills
- Version control: Track skill evolution history
- Publishing workflow: Draft → Review → Published → Archived
- Marketplace: Share and discover skills
- Semantic search: Intelligent search and discovery
📊 OctoTrace
Performance and cost tracing:
- Real-time monitoring: Track skill performance metrics
- Cost tracking: Monitor API costs and usage
- Visualization: Interactive performance dashboards
📚 Skill Wiki
Knowledge management system:
- Knowledge graph: Connect and concepts
- Pattern recognition: Identify success/failure patterns
- Experience distillation: Extract and generalize from interactions
- Versioned documentation: Track knowledge evolution
🤖 AutoSkill
Autonomous research and optimization:
- Auto-experimentation: Self-drive skill experiments
- Auto-optimization: Continuous improvement loop
- Discovery management: Track findings and insights
📦 Installation
Prerequisites
- Python 3.8 or higher
- OpenRouter API key (get one at openrouter.ai)
Quick Install
# Clone the repository
git clone https://github.com/Yuan-ManX/octopai.git
cd octopai
# Install dependencies
pip install -r requirements.txt
# Configure API keys
cp .env.example .env
# Edit .env with your API keys
🚀 Quick Start
Python API
from octopai import Octopai
# Initialize Octopai
octopai = Octopai()
# Convert URL to skill
content = octopai.convert_url("https://example.com")
# Create a skill
skill = octopai.create_skill(
name="Data Analyzer",
description="Analyze CSV data files",
content=content
)
# Start evolution
evolution = octopai.start_evolution(
skill_id=skill.id,
mode="hybrid"
)
Command Line Interface
# Convert URL to Markdown
octopai convert https://example.com -o output.md
# Create a skill
octopai create "A CSV analysis skill" -n csv-analyzer
# Start evolution
octopai evolve csv-analyzer
Web Application
# Start backend (runs on http://localhost:8000)
cd web/backend
python main.py
# Start frontend (runs on http://localhost:5173)
cd web/frontend
npm install
npm run dev
📚 Documentation
Comprehensive documentation available:
Quick links:
📞 Support & Community
- Issues: GitHub Issues
- Documentation: docs/
📄 License
MIT License - see LICENSE for details.
🤝 Contributing
Contributions welcome! See guidelines (coming soon).
⭐ Star History
If you like this project, please ⭐ star the repo! Your support helps us grow!