{"id":31827505,"url":"https://github.com/agentscope-ai/agentscope-java","last_synced_at":"2026-01-16T20:27:59.649Z","repository":{"id":316368078,"uuid":"1062297179","full_name":"agentscope-ai/agentscope-java","owner":"agentscope-ai","description":"AgentScope Java: Agent-Oriented Programming for Building LLM Applications","archived":false,"fork":false,"pushed_at":"2025-09-24T06:12:23.000Z","size":176,"stargazers_count":12,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-24T08:22:56.729Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/agentscope-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-23T04:37:43.000Z","updated_at":"2025-09-24T07:06:57.000Z","dependencies_parsed_at":"2025-09-24T08:23:05.180Z","dependency_job_id":"54d82c28-57f5-4104-b310-acefd7840653","html_url":"https://github.com/agentscope-ai/agentscope-java","commit_stats":null,"previous_names":["agentscope-ai/agentscope-java"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/agentscope-ai/agentscope-java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentscope-ai%2Fagentscope-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentscope-ai%2Fagentscope-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentscope-ai%2Fagentscope-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentscope-ai%2Fagentscope-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/agentscope-ai","download_url":"https://codeload.github.com/agentscope-ai/agentscope-java/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentscope-ai%2Fagentscope-java/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279008295,"owners_count":26084431,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-11T02:00:06.511Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-11T18:55:28.204Z","updated_at":"2026-01-16T20:27:59.623Z","avatar_url":"https://github.com/agentscope-ai.png","language":"Java","funding_links":[],"categories":["人工智能"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg\n    src=\"https://img.alicdn.com/imgextra/i1/O1CN01nTg6w21NqT5qFKH1u_!!6000000001621-55-tps-550-550.svg\"\n    alt=\"AgentScope Logo\"\n    width=\"200\"\n  /\u003e\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003eBuild Production-Ready AI Agents in Java\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://java.agentscope.io/\"\u003e📖 Documentation\u003c/a\u003e\n  \u0026nbsp;|\u0026nbsp;\n  \u003ca href=\"README_zh.md\"\u003e中文\u003c/a\u003e\n  \u0026nbsp;|\u0026nbsp;\n  \u003ca href=\"https://discord.gg/eYMpfnkG8h\"\u003eDiscord\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-Apache--2.0-blue\" alt=\"License\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/JDK-17%2B-orange\" alt=\"JDK 17+\" /\u003e\n  \u003cimg src=\"https://img.shields.io/maven-central/v/io.agentscope/agentscope?color=green\" alt=\"Maven Central\" /\u003e\n  \u003ca href=\"https://deepwiki.com/agentscope-ai/agentscope-java\"\u003e\u003cimg src=\"https://deepwiki.com/badge.svg\" alt=\"Ask DeepWiki\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\nAgentScope Java is an agent-oriented programming framework for building LLM-powered applications. It provides everything you need to create intelligent agents: ReAct reasoning, tool calling, memory management, multi-agent collaboration, and more.\n\n## Highlights\n\n### 🎯 Smart Agents, Full Control\n\nAgentScope adopts the ReAct (Reasoning-Acting) paradigm, enabling agents to autonomously plan and execute complex tasks. Unlike rigid workflow-based approaches, ReAct agents dynamically decide which tools to use and when, adapting to changing requirements in real-time.\n\nHowever, autonomy without control is a liability in production. AgentScope provides comprehensive runtime intervention mechanisms:\n\n- **Safe Interruption** - Pause agent execution at any point while preserving full context and tool state, enabling seamless resumption without data loss\n- **Graceful Cancellation** - Terminate long-running or unresponsive tool calls without corrupting agent state, allowing immediate recovery and redirection\n- **Human-in-the-Loop** - Inject corrections, additional context, or guidance at any reasoning step through the Hook system, maintaining human oversight over critical decisions\n\n### 🛠️ Built-in Tools\n\nAgentScope includes production-ready tools that address common challenges in agent development:\n\n- **PlanNotebook** - A structured task management system that decomposes complex objectives into ordered, trackable steps. Agents can create, modify, pause, and resume multiple concurrent plans, ensuring systematic execution of multi-step workflows.\n\n- **Structured Output** - A self-correcting output parser that guarantees type-safe responses. When LLM output deviates from the expected format, the system automatically detects errors and guides the model to produce valid output, mapping results directly to Java POJOs without manual parsing.\n\n- **Long-term Memory** - Persistent memory storage with semantic search capabilities across sessions. Supports automatic management, agent-controlled recording, or hybrid modes. Enables multi-tenant isolation for enterprise deployments where agents serve multiple users independently.\n\n- **RAG (Retrieval-Augmented Generation)** - Seamless integration with enterprise knowledge bases. Supports both self-hosted embedding-based retrieval and managed services like Alibaba Cloud Bailian, grounding agent responses in authoritative data sources.\n\n### 🔌 Seamless Integration\n\nAgentScope is designed to integrate with existing enterprise infrastructure without requiring extensive modifications:\n\n- **MCP Protocol** - Integrate with any MCP-compatible server to instantly extend agent capabilities. Connect to the growing ecosystem of MCP tools and services—from file systems and databases to web browsers and code interpreters—without writing custom integration code.\n\n- **A2A Protocol** - Enable distributed multi-agent collaboration through standard service discovery. Register agent capabilities to Nacos or similar registries, allowing agents to discover and invoke each other as naturally as calling microservices.\n\n### 🚀 Production Grade\n\nBuilt for enterprise deployment requirements:\n\n- **High Performance** - Reactive architecture based on Project Reactor ensures non-blocking execution. GraalVM native image compilation achieves 200ms cold start times, making AgentScope suitable for serverless and auto-scaling environments.\n\n- **Security Sandbox** - AgentScope Runtime provides isolated execution environments for untrusted tool code. Includes pre-built sandboxes for GUI automation, file system operations, and mobile device interaction, preventing unauthorized access to system resources.\n\n- **Observability** - Native integration with OpenTelemetry for distributed tracing across the entire agent execution pipeline. AgentScope Studio provides visual debugging, real-time monitoring, and comprehensive logging for development and production environments.\n\n## Quick Start\n\n**Requirements:** JDK 17+\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003eio.agentscope\u003c/groupId\u003e\n    \u003cartifactId\u003eagentscope\u003c/artifactId\u003e\n    \u003cversion\u003e1.0.7\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n```java\nReActAgent agent = ReActAgent.builder()\n    .name(\"Assistant\")\n    .sysPrompt(\"You are a helpful AI assistant.\")\n    .model(DashScopeChatModel.builder()\n        .apiKey(System.getenv(\"DASHSCOPE_API_KEY\"))\n        .modelName(\"qwen-max\")\n        .build())\n    .build();\n\nMsg response = agent.call(Msg.builder()\n        .textContent(\"Hello!\")\n        .build()).block();\nSystem.out.println(response.getTextContent());\n```\n\nFor more examples, see the [documentation](https://java.agentscope.io/).\n\n## Contributing\n\nWe welcome contributions! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.\n\n## Community\n\n| [Discord](https://discord.gg/eYMpfnkG8h)                     | DingTalk | WeChat |\n|--------------------------------------------------------------|----------| ---------|\n| \u003cimg src=\"./docs/imgs/discord.png\" width=\"100\" height=\"100\"\u003e | \u003cimg src=\"./docs/imgs/dingtalk_qr_code.jpg\" width=\"100\" height=\"100\"\u003e | \u003cimg src=\"./docs/imgs/wechat.png\" width=\"100\" height=\"100\"\u003e |\n\n## License\n\nApache License 2.0 - see [LICENSE](./LICENSE) for details.\n\n## Publications\n\nIf you find AgentScope helpful, please cite our papers:\n\n- [AgentScope 1.0: A Developer-Centric Framework for Building Agentic Applications](https://arxiv.org/abs/2508.16279)\n- [AgentScope: A Flexible yet Robust Multi-Agent Platform](https://arxiv.org/abs/2402.14034)\n\n## Contributors\n\n\u003ca href=\"https://github.com/agentscope-ai/agentscope-java/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=agentscope-ai/agentscope-java\u0026max=999\u0026columns=12\u0026anon=1\" /\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagentscope-ai%2Fagentscope-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagentscope-ai%2Fagentscope-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagentscope-ai%2Fagentscope-java/lists"}