{"id":15442315,"url":"https://github.com/langchain-ai/langchain-academy","last_synced_at":"2025-04-13T04:55:52.936Z","repository":{"id":255739813,"uuid":"832889750","full_name":"langchain-ai/langchain-academy","owner":"langchain-ai","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-26T18:24:15.000Z","size":39474,"stargazers_count":1118,"open_issues_count":16,"forks_count":741,"subscribers_count":27,"default_branch":"main","last_synced_at":"2025-04-13T04:55:47.894Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://academy.langchain.com","language":"Jupyter Notebook","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/langchain-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}},"created_at":"2024-07-23T23:57:41.000Z","updated_at":"2025-04-12T16:03:39.000Z","dependencies_parsed_at":"2024-09-18T03:15:03.481Z","dependency_job_id":"5cb00f97-6e50-4c27-9906-a51d67e45964","html_url":"https://github.com/langchain-ai/langchain-academy","commit_stats":{"total_commits":154,"total_committers":12,"mean_commits":"12.833333333333334","dds":0.2272727272727273,"last_synced_commit":"37168db0825602f982aac19aa6b34f920e2c399c"},"previous_names":["langchain-ai/langchain-academy"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/langchain-ai%2Flangchain-academy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/langchain-ai%2Flangchain-academy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/langchain-ai%2Flangchain-academy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/langchain-ai%2Flangchain-academy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/langchain-ai","download_url":"https://codeload.github.com/langchain-ai/langchain-academy/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248665763,"owners_count":21142123,"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","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":"2024-10-01T19:26:33.395Z","updated_at":"2025-04-13T04:55:52.906Z","avatar_url":"https://github.com/langchain-ai.png","language":"Jupyter Notebook","funding_links":[],"categories":["Jupyter Notebook"],"sub_categories":[],"readme":"![LangChain Academy](https://cdn.prod.website-files.com/65b8cd72835ceeacd4449a53/66e9eba1020525eea7873f96_LCA-big-green%20(2).svg)\n\n## Introduction\n\nWelcome to LangChain Academy! \nThis is a growing set of modules focused on foundational concepts within the LangChain ecosystem. \nModule 0 is basic setup and Modules 1 - 4 focus on LangGraph, progressively adding more advanced themes. \nIn each module folder, you'll see a set of notebooks. A LangChain Academy accompanies each notebook \nto guide you through the topic. Each module also has a `studio` subdirectory, with a set of relevant \ngraphs that we will explore using the LangGraph API and Studio.\n\n## Setup\n\n### Python version\n\nTo get the most out of this course, please ensure you're using Python 3.11 or later. \nThis version is required for optimal compatibility with LangGraph. If you're on an older version, \nupgrading will ensure everything runs smoothly.\n```\npython3 --version\n```\n\n### Clone repo\n```\ngit clone https://github.com/langchain-ai/langchain-academy.git\n$ cd langchain-academy\n```\n\n### Create an environment and install dependencies\n#### Mac/Linux/WSL\n```\n$ python3 -m venv lc-academy-env\n$ source lc-academy-env/bin/activate\n$ pip install -r requirements.txt\n```\n#### Windows Powershell\n```\nPS\u003e python3 -m venv lc-academy-env\nPS\u003e Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process\nPS\u003e lc-academy-env\\scripts\\activate\nPS\u003e pip install -r requirements.txt\n```\n\n### Running notebooks\nIf you don't have Jupyter set up, follow installation instructions [here](https://jupyter.org/install).\n```\n$ jupyter notebook\n```\n\n### Setting up env variables\nBriefly going over how to set up environment variables. You can also \nuse a `.env` file with `python-dotenv` library.\n#### Mac/Linux/WSL\n```\n$ export API_ENV_VAR=\"your-api-key-here\"\n```\n#### Windows Powershell\n```\nPS\u003e $env:API_ENV_VAR = \"your-api-key-here\"\n```\n\n### Set OpenAI API key\n* If you don't have an OpenAI API key, you can sign up [here](https://openai.com/index/openai-api/).\n*  Set `OPENAI_API_KEY` in your environment \n\n### Sign up and Set LangSmith API\n* Sign up for LangSmith [here](https://smith.langchain.com/), find out more about LangSmith\n* and how to use it within your workflow [here](https://www.langchain.com/langsmith), and relevant library [docs](https://docs.smith.langchain.com/)!\n*  Set `LANGCHAIN_API_KEY`, `LANGCHAIN_TRACING_V2=true` in your environment \n\n### Set up Tavily API for web search\n\n* Tavily Search API is a search engine optimized for LLMs and RAG, aimed at efficient, \nquick, and persistent search results. \n* You can sign up for an API key [here](https://tavily.com/). \nIt's easy to sign up and offers a very generous free tier. Some lessons (in Module 4) will use Tavily. \n\n* Set `TAVILY_API_KEY` in your environment.\n\n### Set up LangGraph Studio\n\n* LangGraph Studio is a custom IDE for viewing and testing agents.\n* Studio can be run locally and opened in your browser on Mac, Windows, and Linux.\n* See documentation [here](https://langchain-ai.github.io/langgraph/concepts/langgraph_studio/#local-development-server) on the local Studio development server and [here](https://langchain-ai.github.io/langgraph/how-tos/local-studio/#run-the-development-server). \n* Graphs for LangGraph Studio are in the `module-x/studio/` folders.\n* To start the local development server, run the following command in your terminal in the `/studio` directory each module:\n\n```\nlanggraph dev\n```\n\nYou should see the following output:\n```\n- 🚀 API: http://127.0.0.1:2024\n- 🎨 Studio UI: https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:2024\n- 📚 API Docs: http://127.0.0.1:2024/docs\n```\n\nOpen your browser and navigate to the Studio UI: `https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:2024`.\n\n* To use Studio, you will need to create a .env file with the relevant API keys\n* Run this from the command line to create these files for module 1 to 6, as an example:\n```\nfor i in {1..6}; do\n  cp module-$i/studio/.env.example module-$i/studio/.env\n  echo \"OPENAI_API_KEY=\\\"$OPENAI_API_KEY\\\"\" \u003e module-$i/studio/.env\ndone\necho \"TAVILY_API_KEY=\\\"$TAVILY_API_KEY\\\"\" \u003e\u003e module-4/studio/.env\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flangchain-ai%2Flangchain-academy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flangchain-ai%2Flangchain-academy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flangchain-ai%2Flangchain-academy/lists"}