The agent engineering platform.
Python agentsaiai-agentsanthropicchatgptdeepagentsenterpriseframeworkgeminigenerative-ailangchainlanggraphllmmultiagentopen-sourceopenaipydanticpythonragtypescript
docs(infra): fix AGENTS.md root setup guidance and package doc accuracy (#40794)
Deepak Thorat2dd956b8add6
diff --git a/.github/workflows/pr_lint.yml b/.github/workflows/pr_lint.ymlindex 4fdb356641..3c9116065b 100644--- a/.github/workflows/pr_lint.yml+++ b/.github/workflows/pr_lint.yml@@ -31,7 +31,7 @@# core, langchain, langchain-classic, model-profiles,# standard-tests, text-splitters, docs, anthropic, chroma, deepseek, exa,# fireworks, groq, huggingface, mistralai, nomic, ollama, openai,-# perplexity, qdrant, xai, infra, deps, partners+# openrouter, perplexity, qdrant, typesafe, xai, infra, deps, partners## Multiple scopes can be used by separating them with a comma. For example:#diff --git a/AGENTS.md b/AGENTS.mdindex 1f51f9b4e0..62d587bb27 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -29,9 +29,10 @@ langchain/│ │ └── ... (other integrations maintained by the LangChain team)│ ├── text-splitters/ # Document chunking utilities│ ├── standard-tests/ # Shared test suite for integrations-│ ├── model-profiles/ # Model configuration profiles+│ └── model-profiles/ # Model configuration profiles├── .github/ # CI/CD workflows and templates├── .vscode/ # VSCode IDE standard settings and recommended extensions+├── openwiki/ # Generated just-in-time evidence index (optional reading)└── README.md # Information about LangChain```@@ -43,14 +44,14 @@ langchain/### Development tools & commands- `uv` – Fast Python package installer and resolver (replaces pip/poetry)-- `make` – Task runner for common development commands. Feel free to look at the `Makefile` for available commands and usage patterns.+- `make` – Task runner for common development commands. Each package under `libs/` has its own `Makefile`; feel free to look at it for available commands and usage patterns.- `ruff` – Fast Python linter and formatter- `mypy` – Static type checking- `pytest` – Testing framework-This monorepo uses `uv` for dependency management. Local development uses editable installs: `[tool.uv.sources]`+This monorepo uses `uv` for dependency management. Local development uses editable installs declared under each package's `[tool.uv.sources]` table in `pyproject.toml`, so path dependencies resolve to your working tree instead of PyPI.-Each package in `libs/` has its own `pyproject.toml` and `uv.lock`.+Each package in `libs/` has its own `pyproject.toml`, `uv.lock`, and `Makefile`. There is no workspace-level `pyproject.toml` or `Makefile` at the repo root — always `cd` into the package you are working on before running the commands below (for example `cd libs/langchain_v1` or `cd libs/core`).Before running your tests, set up all packages by running:@@ -92,9 +93,13 @@ Use `uv` for all environment and dependency operations in this monorepo. Do not#### Key config files-- pyproject.toml: Main workspace configuration with dependency groups-- uv.lock: Locked dependencies for reproducible builds-- Makefile: Development tasks+There is no single workspace config at the repository root. Configuration lives per package:++- `libs/<package>/pyproject.toml`: Package metadata and dependency groups (`test`, `lint`, `typing`, `dev`, …)+- `libs/<package>/uv.lock`: Locked dependencies for reproducible builds+- `libs/<package>/Makefile`: Development tasks for that package (`test`, `lint`, `format`, `type`, …)+- `libs/Makefile`: Cross-package `lock` / `check-lock` only+- `.pre-commit-config.yaml` (repo root): Git hooks that run per-package format/lint#### PR and commit titles@@ -364,7 +369,7 @@ When adding a new partner package, update these files:## GitHub Actions & Workflows-This repository require actions to be pinned to a full-length commit SHA. Attempting to use a tag will fail. Use the `gh` cli to query. Verify tags are not annotated tag objects (which would need dereferencing).+This repository requires actions to be pinned to a full-length commit SHA. Attempting to use a tag will fail. Use the `gh` cli to query. Verify tags are not annotated tag objects (which would need dereferencing).## Additional resourcesdiff --git a/README.md b/README.mdindex de6af66fd6..aeea8c3876 100644--- a/README.md+++ b/README.md@@ -24,7 +24,7 @@LangChain is a framework for building agents and LLM-powered applications. It helps you chain together interoperable components and third-party integrations to simplify AI application development — all while future-proofing decisions as the underlying technology evolves.> [!TIP]-> Just getting started? Check out **[Deep Agents](http://docs.langchain.com/oss/python/deepagents/)** — a higher-level package built on LangChain for agents that have built-in capabilities for common usage patterns such as planning, subagents, file system usage, and more.+> Just getting started? Check out **[Deep Agents](https://docs.langchain.com/oss/python/deepagents/)** — a higher-level package built on LangChain for agents that have built-in capabilities for common usage patterns such as planning, subagents, file system usage, and more.## Quickstart@@ -50,7 +50,7 @@ For an equivalent JS/TS library, check out [LangChain.js](https://github.com/lanWhile the LangChain framework can be used standalone, it also integrates seamlessly with any LangChain product, giving developers a full suite of tools when building LLM applications.-- **[Deep Agents](http://docs.langchain.com/oss/python/deepagents/)** — Build agents that can plan, use subagents, and leverage file systems for complex tasks+- **[Deep Agents](https://docs.langchain.com/oss/python/deepagents/)** — Build agents that can plan, use subagents, and leverage file systems for complex tasks- **[LangGraph](https://docs.langchain.com/oss/python/langgraph/overview)** — Build agents that can reliably handle complex tasks with our low-level agent orchestration framework- **[Integrations](https://docs.langchain.com/oss/python/integrations/providers/overview)** — Chat & embedding models, tools & toolkits, and more- **[LangSmith](https://www.langchain.com/langsmith)** — Agent evals, observability, and debugging for LLM appsdiff --git a/libs/README.md b/libs/README.mdindex 941a5e3038..497c39d2f4 100644--- a/libs/README.md+++ b/libs/README.md@@ -12,6 +12,7 @@ This repository is structured as a monorepo, with various packages located in thcore/ # Core primitives and abstractions for langchainlangchain/ # langchain-classiclangchain_v1/ # langchain+model-profiles/ # Model capability profiles and CLI (`langchain-model-profiles`)partners/ # Certain third-party providers integrations (see below)standard-tests/ # Standardized tests for integrationstext-splitters/ # Text splitter utilitiesdiff --git a/libs/langchain_v1/Makefile b/libs/langchain_v1/Makefileindex 9367f4422e..211e295be9 100644--- a/libs/langchain_v1/Makefile+++ b/libs/langchain_v1/Makefile@@ -126,4 +126,3 @@ help:@echo 'extended_tests - run only extended unit tests'@echo 'test_watch - run unit tests in watch mode'@echo 'integration_tests - run integration tests'- @echo '-- DOCUMENTATION tasks are from the top-level Makefile --'