docs: make Chinese README the default
snapshot_release / snapshot_release (push) Has been cancelled
Split Package Detection / check-split-packages (push) Has been cancelled

This commit is contained in:
wehub-resource-sync
2026-07-13 10:47:00 +00:00
parent d12c54de5e
commit 6dd36e490d
+52 -46
View File
@@ -1,4 +1,10 @@
# LangChain4j: idiomatic, open-source Java library for building LLM-powered applications on the JVM
<!-- WEHUB_ZH_README -->
> [!NOTE]
> 本文档由 WeHub 基于上游 README 翻译整理,属于社区翻译,非官方中文文档。
> [English](./README.en.md) · [原始项目](https://github.com/langchain4j/langchain4j) · [上游 README](https://github.com/langchain4j/langchain4j/blob/HEAD/README.md)
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
# LangChain4j:用于在 JVM 上构建 LLM 驱动应用的惯用、开源 Java 库
[![Build Status](https://img.shields.io/github/actions/workflow/status/langchain4j/langchain4j/main.yaml?branch=main&style=for-the-badge&label=CI%20BUILD&logo=github)](https://github.com/langchain4j/langchain4j/actions/workflows/main.yaml)
[![Nightly Build](https://img.shields.io/github/actions/workflow/status/langchain4j/langchain4j/nightly_jdk17.yaml?branch=main&style=for-the-badge&label=NIGHTLY%20BUILD&logo=github)](https://github.com/langchain4j/langchain4j/actions/workflows/nightly_jdk17.yaml)
@@ -12,74 +18,74 @@
## Introduction
Welcome!
欢迎!
The goal of LangChain4j is to simplify integrating LLMs into Java applications.
LangChain4j 的目标是让 LLM 集成到 Java 应用中变得更简单。
Here's how:
1. **Unified APIs:**
LLM providers (like OpenAI or Google Vertex AI) and embedding (vector) stores (such as Pinecone or Milvus)
use proprietary APIs. LangChain4j offers a unified API to avoid the need for learning and implementing specific APIs for each of them.
To experiment with different LLMs or embedding stores, you can easily switch between them without the need to rewrite your code.
LangChain4j currently supports [20+ popular LLM providers](https://docs.langchain4j.dev/integrations/language-models/)
and [30+ embedding stores](https://docs.langchain4j.dev/integrations/embedding-stores/).
2. **Comprehensive Toolbox:**
Since early 2023, the community has been building numerous LLM-powered applications,
identifying common abstractions, patterns, and techniques. LangChain4j has refined these into practical code.
Our toolbox includes tools ranging from low-level prompt templating, chat memory management, and function calling
to high-level patterns like Agents and RAG.
For each abstraction, we provide an interface along with multiple ready-to-use implementations based on common techniques.
Whether you're building a chatbot or developing a RAG with a complete pipeline from data ingestion to retrieval,
LangChain4j offers a wide variety of options.
3. **Numerous Examples:**
These [examples](https://github.com/langchain4j/langchain4j-examples) showcase how to begin creating various LLM-powered applications,
providing inspiration and enabling you to start building quickly.
实现方式如下:
1. **统一 API**
LLM 提供商(如 OpenAI Google Vertex AI)和嵌入(向量)存储(如 Pinecone Milvus
各自使用专有 APILangChain4j 提供统一 API,避免为每个服务单独学习和实现其 API。
若要尝试不同的 LLM 或嵌入存储,你可以轻松切换,而无需重写代码。
LangChain4j 目前支持 [20+ 主流 LLM 提供商](https://docs.langchain4j.dev/integrations/language-models/)
以及 [30+ 嵌入存储](https://docs.langchain4j.dev/integrations/embedding-stores/).
2. **全面的工具箱:**
自 2023 年初以来,社区已构建了大量 LLM 驱动应用,
并总结出常见的抽象、模式与技术。LangChain4j 将这些沉淀为可落地的代码。
我们的工具箱涵盖从底层提示词模板、对话记忆管理、函数调用(function calling
到 Agents、RAG 等高层模式。
针对每种抽象,我们都提供接口,以及基于常见技术的多种开箱即用实现。
无论你是在构建聊天机器人,还是开发从数据摄取到检索的完整 RAG 流水线,
LangChain4j 都能提供丰富选择。
3. **丰富的示例:**
这些[示例](https://github.com/langchain4j/langchain4j-examples) 展示了如何开始创建各类 LLM 驱动应用,
既能提供灵感,也能让你快速上手。
LangChain4j began development in early 2023 amid the ChatGPT hype.
We noticed a lack of Java counterparts to the numerous Python and JavaScript LLM libraries and frameworks,
and we had to fix that!
LangChain4j 于 2023 年初 ChatGPT 热潮中开始开发。
我们注意到,相比众多的 Python JavaScript LLM 库和框架,Java 生态缺少对应方案,
而我们需要补上这一空白!
**Despite the name, LangChain4j is not a Java port of LangChain (Python) — it is built for Java, not ported to it.**
It is an idiomatic Java library designed from the ground up around Java conventions:
type safety, POJOs, annotations, interfaces, dependency injection, fluent APIs, and first-class integrations with Quarkus, Spring Boot, Helidon, and Micronaut.
Its API, internals, and release cycle are independent of the Python LangChain project.
**尽管名字相似,LangChain4j 并非 LangChainPython)的 Java 移植版——它是为 Java 而生,而非从其他语言移植而来。**
它是一款惯用的 Java 库,从设计之初就围绕 Java 惯例构建:
类型安全、POJO、注解、接口、依赖注入、流式 API(fluent APIs),以及与 QuarkusSpring BootHelidonMicronaut 的一等集成。
API、内部实现与发布周期均独立于 Python LangChain 项目。
We actively monitor community developments, aiming to quickly incorporate new techniques and integrations,
ensuring you stay up-to-date.
The library is under active development. While some features are still being worked on,
the core functionality is in place, allowing you to start building LLM-powered apps now!
我们持续关注社区动态,力求快速纳入新技术与集成,
确保你始终跟上最新进展。
该库仍在积极开发中。虽然部分功能仍在完善,
但核心能力已就绪,你现在就可以开始构建 LLM 驱动应用!
## Documentation
Documentation can be found [here](https://docs.langchain4j.dev).
文档见[此处](https://docs.langchain4j.dev).
The documentation chatbot (experimental) can be found [here](https://chat.langchain4j.dev/).
文档聊天机器人(实验性)见[此处](https://chat.langchain4j.dev/).
## Getting Started
Getting started guide can be found [here](https://docs.langchain4j.dev/get-started).
入门指南见[此处](https://docs.langchain4j.dev/get-started).
## Code Examples
Please see examples of how LangChain4j can be used in [langchain4j-examples](https://github.com/langchain4j/langchain4j-examples) repo:
- [Examples in plain Java](https://github.com/langchain4j/langchain4j-examples/tree/main/other-examples/src/main/java)
- [Examples with Quarkus](https://github.com/quarkiverse/quarkus-langchain4j/tree/main/samples) (uses [quarkus-langchain4j](https://github.com/quarkiverse/quarkus-langchain4j) dependency)
- [Example with Spring Boot](https://github.com/langchain4j/langchain4j-examples/tree/main/spring-boot-example/src/main/java/dev/langchain4j/example)
- [Examples with Helidon](https://github.com/helidon-io/helidon-examples/tree/helidon-4.x/examples/integrations/langchain4j) (uses [io.helidon.integrations.langchain4j](https://mvnrepository.com/artifact/io.helidon.integrations.langchain4j) dependency)
- [Examples with Micronaut](https://github.com/micronaut-projects/micronaut-langchain4j/tree/0.3.x/doc-examples/example-openai-java) (uses [micronaut-langchain4j](https://micronaut-projects.github.io/micronaut-langchain4j/latest/guide/) dependency)
LangChain4j 用法示例请参见 [langchain4j-examples](https://github.com/langchain4j/langchain4j-examples) 仓库:
- [ Java 示例](https://github.com/langchain4j/langchain4j-examples/tree/main/other-examples/src/main/java)
- [Quarkus 示例](https://github.com/quarkiverse/quarkus-langchain4j/tree/main/samples)(使用 [quarkus-langchain4j](https://github.com/quarkiverse/quarkus-langchain4j) 依赖)
- [Spring Boot 示例](https://github.com/langchain4j/langchain4j-examples/tree/main/spring-boot-example/src/main/java/dev/langchain4j/example)
- [Helidon 示例](https://github.com/helidon-io/helidon-examples/tree/helidon-4.x/examples/integrations/langchain4j)(使用 [io.helidon.integrations.langchain4j](https://mvnrepository.com/artifact/io.helidon.integrations.langchain4j) 依赖)
- [Micronaut 示例](https://github.com/micronaut-projects/micronaut-langchain4j/tree/0.3.x/doc-examples/example-openai-java)(使用 [micronaut-langchain4j](https://micronaut-projects.github.io/micronaut-langchain4j/latest/guide/) 依赖)
## Useful Materials
Useful materials can be found [here](https://docs.langchain4j.dev/useful-materials).
实用资料见[此处](https://docs.langchain4j.dev/useful-materials).
## Get Help
Please use [Discord](https://discord.gg/JzTFvyjG6R) or [GitHub discussions](https://github.com/langchain4j/langchain4j/discussions)
to get help.
如需帮助,请使用 [Discord](https://discord.gg/JzTFvyjG6R) [GitHub discussions](https://github.com/langchain4j/langchain4j/discussions)
## Request Features
Please let us know what features you need by [opening an issue](https://github.com/langchain4j/langchain4j/issues/new/choose).
请通过[提交 issue](https://github.com/langchain4j/langchain4j/issues/new/choose). 告知我们你需要的功能。
## Contribute
Contribution guidelines can be found [here](https://github.com/langchain4j/langchain4j/blob/main/CONTRIBUTING.md).
贡献指南见[此处](https://github.com/langchain4j/langchain4j/blob/main/CONTRIBUTING.md).