This repository implements a multi-agent AI system for generating comprehensive company research reports. The backend is a FastAPI application that orchestrates a LangGraph-based pipeline of specialized research agents: a grounding node that optionally crawls the company's website, parallel research nodes (company, industry, financial, news) that use Tavily search and LLM-generated queries to gather data, a curator that filters documents by relevance score, an enricher that fetches raw content, a briefing node that generates category-specific summaries using Gemini, and an editor that compiles the final report using GPT-4o. The frontend is a React application with TypeScript and Tailwind CSS that communicates via SSE streaming. The system is primarily a web application with a modular agent pipeline, not a data analysis project.
This is an educational repository of Python scripts, mini-projects, and markdown guides for building LLM-based AI agents applied to cybersecurity. The code is organized into five progressive parts: foundational LLM/embeddings usage, prompt templates, prompt chaining, RAG over security data, and agentic workflows. It demonstrates multiple agent frameworks (LangChain, LangGraph, CrewAI, DeepAgents) and MCP server integrations for tools like nmap and Shodan. The dominant character is application/tutorial code rather than data research, although it bundles small datasets (CVE embeddings, sample RAG corpora) and commits Chroma vector stores for offline exercises. The repo is not a single deployable service; it is a collection of entry-point scripts and small frameworks. Architecture is a set of standalone examples with shared patterns: state graphs for orchestration, YAML-configured crews, MCP adapters, and RAG ingestion/query pipelines. Most scripts require OpenAI-compatible API keys and/or local tools such as nmap/Ollama. Simulated data and placeholder responses in some examples make it a learning environment rather than production security tooling. Maintenance is current but drift is moderate: some examples use deprecated langchain vectorstore imports, documentation is duplicated across subdirectories, several referenced files are missing, and hardcoded model strings like gpt-5.4-mini appear dated or fictional. There is no root-level automated test suite; only the Shodan MCP subproject contains tests. The strongest reusable patterns are the MCP server wrapping, LangGraph conditional-state orchestration, CrewAI declarative crew configuration, and the hierarchical SOC agent supervisor.
This repository is a comprehensive educational resource for learning and building AI agents using the LangGraph framework. It consists of numerous tutorials and examples organized by chapter, covering fundamental concepts such as state graphs and tool usage, as well as advanced patterns including Retrieval-Augmented Generation (RAG), multi-agent supervisor systems, and human-in-the-loop workflows. Each lesson is designed as a runnable script that demonstrates specific LangGraph integrations with various APIs (e.g., OpenAI, Tavily, OpenWeatherMap) and techniques like vector stores with Chroma. While the repository serves its purpose as a learning tool, it exhibits some maintenance challenges due to code duplication (e.g., multiple copies of display_graph.py across chapters) and contains at least one known flawed implementation (the audit data monitor in chapter13) that suffers from schema mismatches and inefficient API usage, as indicated by log files.