deepcode-hku 1.0.1__py3-none-any.whl

cli/cli_launcher.py

@@ -0,0 +1,155 @@
+#!/usr/bin/env python3
+"""
+DeepCode - CLI Research Engine Launcher
+DeepCode - CLI研究引擎启动器
+
+🧬 Open-Source Code Agent by Data Intelligence Lab @ HKU (CLI Edition)
+⚡ Revolutionizing research reproducibility through collaborative AI via command line
+"""
+
+import sys
+from pathlib import Path
+
+
+def check_dependencies():
+    """检查必要的依赖是否已安装 / Check if necessary dependencies are installed"""
+    import importlib.util
+
+    print("🔍 Checking CLI dependencies...")
+
+    missing_deps = []
+
+    # Check asyncio availability
+    if importlib.util.find_spec("asyncio") is not None:
+        print("✅ Asyncio is available")
+    else:
+        missing_deps.append("asyncio")
+
+    # Check PyYAML availability
+    if importlib.util.find_spec("yaml") is not None:
+        print("✅ PyYAML is installed")
+    else:
+        missing_deps.append("pyyaml")
+
+    # Check Tkinter availability
+    if importlib.util.find_spec("tkinter") is not None:
+        print("✅ Tkinter is available (for file dialogs)")
+    else:
+        print("⚠️  Tkinter not available - file dialogs will use manual input")
+
+    # Check for MCP agent dependencies
+    if importlib.util.find_spec("mcp_agent.app") is not None:
+        print("✅ MCP Agent framework is available")
+    else:
+        missing_deps.append("mcp-agent")
+
+    # Check for workflow dependencies
+    # 添加项目根目录到路径
+    current_dir = Path(__file__).parent
+    project_root = current_dir.parent
+    if str(project_root) not in sys.path:
+        sys.path.insert(0, str(project_root))
+
+    if importlib.util.find_spec("workflows.agent_orchestration_engine") is not None:
+        print("✅ Workflow modules are available")
+    else:
+        print("⚠️  Workflow modules may not be properly configured")
+
+    # Check for CLI components
+    if importlib.util.find_spec("cli.cli_app") is not None:
+        print("✅ CLI application components are available")
+    else:
+        print("❌ CLI application components missing")
+        missing_deps.append("cli-components")
+
+    if missing_deps:
+        print("\n❌ Missing dependencies:")
+        for dep in missing_deps:
+            print(f"   - {dep}")
+        print("\nPlease install missing dependencies using:")
+        print(
+            f"pip install {' '.join([d for d in missing_deps if d != 'cli-components'])}"
+        )
+        if "cli-components" in missing_deps:
+            print(
+                "CLI components appear to be missing - please check the cli/ directory"
+            )
+        return False
+
+    print("✅ All CLI dependencies satisfied")
+    return True
+
+
+def print_banner():
+    """显示CLI启动横幅 / Display CLI startup banner"""
+    banner = """
+╔══════════════════════════════════════════════════════════════╗
+║                                                              ║
+║    🧬 DeepCode - Open-Source Code Agent                      ║
+║                                                              ║
+║    ⚡ DATA INTELLIGENCE LAB @ HKU ⚡                        ║
+║                                                              ║
+║                               ║
+║                                                              ║
+╚══════════════════════════════════════════════════════════════╝
+"""
+    print(banner)
+
+
+def main():
+    """主函数 / Main function"""
+    print_banner()
+
+    # 检查依赖 / Check dependencies
+    if not check_dependencies():
+        print("\n🚨 Please install missing dependencies and try again.")
+        sys.exit(1)
+
+    # 获取当前脚本目录 / Get current script directory
+    current_dir = Path(__file__).parent
+    project_root = current_dir.parent
+    cli_app_path = current_dir / "cli_app.py"
+
+    # 检查cli_app.py是否存在 / Check if cli_app.py exists
+    if not cli_app_path.exists():
+        print(f"❌ CLI application file not found: {cli_app_path}")
+        print("Please ensure the cli/cli_app.py file exists.")
+        sys.exit(1)
+
+    print(f"\n📁 CLI App location: {cli_app_path}")
+    print("🖥️  Starting DeepCode CLI interface...")
+    print("🚀 Initializing command line application")
+    print("=" * 70)
+    print("💡 Tip: Follow the interactive prompts to process your research")
+    print("🛑 Press Ctrl+C to exit at any time")
+    print("=" * 70)
+
+    # 启动CLI应用 / Launch CLI application
+    try:
+        # 导入并运行CLI应用
+        if str(project_root) not in sys.path:
+            sys.path.insert(0, str(project_root))  # 添加项目根目录到路径
+        from cli.cli_app import main as cli_main
+
+        print("\n🎯 Launching CLI application...")
+
+        # 使用asyncio运行主函数
+        import asyncio
+
+        asyncio.run(cli_main())
+
+    except KeyboardInterrupt:
+        print("\n\n🛑 DeepCode CLI stopped by user")
+        print("Thank you for using DeepCode CLI! 🧬")
+    except ImportError as e:
+        print(f"\n❌ Failed to import CLI application: {e}")
+        print("Please check if all modules are properly installed.")
+        sys.exit(1)
+    except Exception as e:
+        print(f"\n❌ Unexpected error: {e}")
+        print("Please check your Python environment and try again.")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

cli/main_cli.py

@@ -0,0 +1,243 @@
+#!/usr/bin/env python3
+"""
+DeepCode CLI - Open-Source Code Agent
+深度代码CLI - 开源代码智能体
+
+🧬 Data Intelligence Lab @ HKU
+⚡ Revolutionizing Research Reproducibility through Multi-Agent Architecture
+"""
+
+import os
+import sys
+import asyncio
+import argparse
+
+# 禁止生成.pyc文件
+os.environ["PYTHONDONTWRITEBYTECODE"] = "1"
+
+# 添加项目根目录到路径
+current_dir = os.path.dirname(os.path.abspath(__file__))
+parent_dir = os.path.dirname(current_dir)
+if parent_dir not in sys.path:
+    sys.path.insert(0, parent_dir)
+
+# 导入CLI应用
+from cli.cli_app import CLIApp, Colors
+
+
+def print_enhanced_banner():
+    """显示增强版启动横幅"""
+    banner = f"""
+{Colors.CYAN}╔══════════════════════════════════════════════════════════════════════════════╗
+║                                                                              ║
+║    {Colors.BOLD}{Colors.MAGENTA}🧬 DeepCode - Open-Source Code Agent{Colors.CYAN}                              ║
+║                                                                              ║
+║    {Colors.BOLD}{Colors.YELLOW}⚡ DATA INTELLIGENCE LAB @ HKU ⚡{Colors.CYAN}                                ║
+║                                                                              ║
+║    Revolutionizing research reproducibility through collaborative AI         ║
+║    Building the future where code is reproduced from natural language       ║
+║                                                                              ║
+║    {Colors.BOLD}{Colors.GREEN}🤖 Key Features:{Colors.CYAN}                                                    ║
+║    • Automated paper-to-code reproduction                                   ║
+║    • Multi-agent collaborative architecture                                 ║
+║    • Open-source and extensible design                                      ║
+║    • Join our growing research community                                    ║
+║                                                                              ║
+╚══════════════════════════════════════════════════════════════════════════════╝{Colors.ENDC}
+"""
+    print(banner)
+
+
+def check_environment():
+    """检查运行环境"""
+    print(f"{Colors.CYAN}🔍 Checking environment...{Colors.ENDC}")
+
+    # 检查Python版本
+    if sys.version_info < (3, 8):
+        print(
+            f"{Colors.FAIL}❌ Python 3.8+ required. Current: {sys.version}{Colors.ENDC}"
+        )
+        return False
+
+    print(f"{Colors.OKGREEN}✅ Python {sys.version.split()[0]} - OK{Colors.ENDC}")
+
+    # 检查必要模块
+    required_modules = [
+        ("asyncio", "Async IO support"),
+        ("pathlib", "Path handling"),
+        ("typing", "Type hints"),
+    ]
+
+    missing_modules = []
+    for module, desc in required_modules:
+        try:
+            __import__(module)
+            print(f"{Colors.OKGREEN}✅ {desc} - OK{Colors.ENDC}")
+        except ImportError:
+            missing_modules.append(module)
+            print(f"{Colors.FAIL}❌ {desc} - Missing{Colors.ENDC}")
+
+    if missing_modules:
+        print(
+            f"{Colors.FAIL}❌ Missing required modules: {', '.join(missing_modules)}{Colors.ENDC}"
+        )
+        return False
+
+    print(f"{Colors.OKGREEN}✅ Environment check passed{Colors.ENDC}")
+    return True
+
+
+def parse_arguments():
+    """解析命令行参数"""
+    parser = argparse.ArgumentParser(
+        description="DeepCode CLI - Open-Source Code Agent by Data Intelligence Lab @ HKU",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog=f"""
+{Colors.BOLD}Examples:{Colors.ENDC}
+  {Colors.CYAN}python main_cli.py{Colors.ENDC}                    # Interactive mode
+  {Colors.CYAN}python main_cli.py --file paper.pdf{Colors.ENDC}     # Process file directly
+  {Colors.CYAN}python main_cli.py --url https://...{Colors.ENDC}    # Process URL directly
+  {Colors.CYAN}python main_cli.py --chat "Build a web app..."{Colors.ENDC} # Process chat requirements
+  {Colors.CYAN}python main_cli.py --optimized{Colors.ENDC}          # Use optimized mode
+
+{Colors.BOLD}Pipeline Modes:{Colors.ENDC}
+  {Colors.GREEN}Comprehensive{Colors.ENDC}: Full intelligence analysis with indexing
+  {Colors.YELLOW}Optimized{Colors.ENDC}:     Fast processing without indexing
+        """,
+    )
+
+    parser.add_argument(
+        "--file", "-f", type=str, help="Process a specific file (PDF, DOCX, TXT, etc.)"
+    )
+
+    parser.add_argument(
+        "--url", "-u", type=str, help="Process a research paper from URL"
+    )
+
+    parser.add_argument(
+        "--chat",
+        "-t",
+        type=str,
+        help="Process coding requirements via chat input (provide requirements as argument)",
+    )
+
+    parser.add_argument(
+        "--optimized",
+        "-o",
+        action="store_true",
+        help="Use optimized mode (skip indexing for faster processing)",
+    )
+
+    parser.add_argument(
+        "--verbose", "-v", action="store_true", help="Enable verbose output"
+    )
+
+    return parser.parse_args()
+
+
+async def run_direct_processing(app: CLIApp, input_source: str, input_type: str):
+    """直接处理模式（非交互式）"""
+    try:
+        print(
+            f"\n{Colors.BOLD}{Colors.CYAN}🚀 Starting direct processing mode...{Colors.ENDC}"
+        )
+        print(f"{Colors.CYAN}Input: {input_source}{Colors.ENDC}")
+        print(f"{Colors.CYAN}Type: {input_type}{Colors.ENDC}")
+        print(
+            f"{Colors.CYAN}Mode: {'🧠 Comprehensive' if app.cli.enable_indexing else '⚡ Optimized'}{Colors.ENDC}"
+        )
+
+        # 初始化应用
+        init_result = await app.initialize_mcp_app()
+        if init_result["status"] != "success":
+            print(
+                f"{Colors.FAIL}❌ Initialization failed: {init_result['message']}{Colors.ENDC}"
+            )
+            return False
+
+        # 处理输入
+        result = await app.process_input(input_source, input_type)
+
+        if result["status"] == "success":
+            print(
+                f"\n{Colors.BOLD}{Colors.OKGREEN}🎉 Processing completed successfully!{Colors.ENDC}"
+            )
+            return True
+        else:
+            print(
+                f"\n{Colors.BOLD}{Colors.FAIL}❌ Processing failed: {result.get('error', 'Unknown error')}{Colors.ENDC}"
+            )
+            return False
+
+    except Exception as e:
+        print(f"\n{Colors.FAIL}❌ Direct processing error: {str(e)}{Colors.ENDC}")
+        return False
+    finally:
+        await app.cleanup_mcp_app()
+
+
+async def main():
+    """主函数"""
+    # 解析命令行参数
+    args = parse_arguments()
+
+    # 显示横幅
+    print_enhanced_banner()
+
+    # 检查环境
+    if not check_environment():
+        print(
+            f"\n{Colors.FAIL}🚨 Environment check failed. Please fix the issues and try again.{Colors.ENDC}"
+        )
+        sys.exit(1)
+
+    try:
+        # 创建CLI应用
+        app = CLIApp()
+
+        # 设置配置
+        if args.optimized:
+            app.cli.enable_indexing = False
+            print(
+                f"\n{Colors.YELLOW}⚡ Optimized mode enabled - indexing disabled{Colors.ENDC}"
+            )
+        else:
+            print(
+                f"\n{Colors.GREEN}🧠 Comprehensive mode enabled - full intelligence analysis{Colors.ENDC}"
+            )
+
+        # 检查是否为直接处理模式
+        if args.file or args.url or args.chat:
+            if args.file:
+                # 验证文件存在
+                if not os.path.exists(args.file):
+                    print(f"{Colors.FAIL}❌ File not found: {args.file}{Colors.ENDC}")
+                    sys.exit(1)
+                success = await run_direct_processing(app, args.file, "file")
+            elif args.url:
+                success = await run_direct_processing(app, args.url, "url")
+            elif args.chat:
+                # 验证chat输入长度
+                if len(args.chat.strip()) < 20:
+                    print(
+                        f"{Colors.FAIL}❌ Chat input too short. Please provide more detailed requirements (at least 20 characters){Colors.ENDC}"
+                    )
+                    sys.exit(1)
+                success = await run_direct_processing(app, args.chat, "chat")
+
+            sys.exit(0 if success else 1)
+        else:
+            # 交互式模式
+            print(f"\n{Colors.CYAN}🎮 Starting interactive mode...{Colors.ENDC}")
+            await app.run_interactive_session()
+
+    except KeyboardInterrupt:
+        print(f"\n{Colors.WARNING}⚠️  Application interrupted by user{Colors.ENDC}")
+        sys.exit(1)
+    except Exception as e:
+        print(f"\n{Colors.FAIL}❌ Application errors: {str(e)}{Colors.ENDC}")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

cli/workflows/__init__.py

@@ -0,0 +1,11 @@
+"""
+CLI-specific Workflow Adapters
+CLI专用工作流适配器
+
+This module provides CLI-optimized versions of workflow components that are
+specifically adapted for command-line interface usage patterns.
+"""
+
+from .cli_workflow_adapter import CLIWorkflowAdapter
+
+__all__ = ["CLIWorkflowAdapter"]