README

Robin


  An open-source software factory built on Deep Agents by LangChain.



  
  
  
  
  




Robin turns engineering work into a repeatable system: investigate a codebase, implement changes, validate them, and deliver a pull request.
It also reviews pull requests, learns repository-specific review preferences, monitors CI, and responds to feedback.
Built by LangChain, it is open source and deployable in your infrastructure.

 [!NOTE]
 Under active development.
 Expect breaking changes and rough edges.
 We’re not accepting issues or external contributions at this time.
 You’re welcome to explore and fork the code, but correctness, stability, and compatibility are not guaranteed.

 If you really want to deploy it yourself, follow the installation guide.
 Deploying it as is requires Managed Deep Agents, which runs its agent; without it, we recommend forking and adapting the code to your own runtime.

 What Robin does

mermaid
flowchart LR
    A[Issues, conversations, PRs, schedules] -- B[Plan and investigate]
    B -- C[Implement in an isolated sandbox]
    C -- D[Validate and deliver a PR]
    D -- E[Review, CI, and feedback]
    E --|Follow-up work| B


- Build: Investigate repositories, edit code, run focused validation, and open or update pull requests.
- Parallelize: Use subagents for research and independent work.
- Review: Run on-demand or opt-in automatic reviews, publish findings to GitHub, and learn from historical feedback.
- Investigate: Use read-only PR chat to understand a change without implementing changes.
- Operate: Schedule recurring tasks and monitor opted-in PRs with /baby-sit, diagnosing failures and rerunning only evidence-backed flaky jobs.
- Customize: Choose models, reasoning effort, instructions, skills, integrations, and sandbox providers.

Start and continue work from the dashboard, GitHub issues and PR conversations, or Slack.
In Linear, mention or delegate an issue to the Robin app to open an agent session.
Cloud coding follow-ups reuse the thread’s context and sandbox; independent threads can run in parallel.

 How it works

Deep Agents supplies planning, filesystem, shell, skills, and subagent primitives.
LangGraph provides durable execution and thread state.
Robin adds engineering tools, integrations, authorization, and user interfaces.
The graph entrypoints are declared in langgraph.json, with an architecture inventory.

Cloud coding runs in persistent, per-thread Linux sandboxes with tooling supplied by workspace scripts or snapshots.
An unreachable coding sandbox is not silently replaced.
LangSmith is the default sandbox and tracing provider; other providers and local execution are configurable.
PR chat does not need a sandbox.

 Control and safety

- GitHub access: Coding sandboxes normally receive installation-wide GitHub App access; selected workflows use narrower repository scopes.
  Workspace repository bindings control routing and preloaded checkouts, not a separate credential boundary.
  See GitHub a