Skip to content

tutorial.md

Latest commit

 

History

History
246 lines (171 loc) · 6.33 KB

tutorial.md

File metadata and controls

246 lines (171 loc) · 6.33 KB

Tutorial: Your First Deal Flow in 30 Minutes

This tutorial walks you through a complete InGa deal flow -- from installation to receiving deal dossiers with outreach drafts in your vault. Estimated time: 30 minutes.

Prerequisites:

Step 1: Clone and Install (5 minutes)

git clone https://github.com/Bundelkund/InGa
cd InGa
npm install
cp .env.example .env.local

Open .env.local in your editor and set your Anthropic API key:

ANTHROPIC_API_KEY=sk-ant-api03-...

Verify the installation:

npx tsx src/cli/index.ts --help
# Should show: inga [options] [command]

Step 2: Start FalkorDB (5 minutes)

FalkorDB is the intelligence graph backend. Start it with Docker:

docker-compose up -d falkordb

Verify FalkorDB is running:

docker-compose ps falkordb
# State should be: Up

Verify your environment (API keys + provider connectivity):

npx tsx src/cli/index.ts setup

FalkorDB is schemaless — no migration step needed. Confirm the graph is ready:

npx tsx src/cli/index.ts stats
# Expected output: graph_nodes=0 graph_edges=0

Step 3: Create Your Vault (5 minutes)

The vault is your Markdown-based workspace. Create it:

npx tsx src/cli/index.ts init ~/inga-vault

This copies the vault template to ~/inga-vault/ with:

  • 00_theses/ -- where you put thesis files
  • 10_pipeline/ -- where dossiers appear
  • 99_config/ -- agent definitions and vault config

Verify:

ls ~/inga-vault/
# 00_theses  10_pipeline  20_portfolio  30_network  99_config  README.md

Step 4: Write Your Thesis (5 minutes)

Copy the thesis template and fill it in:

cp ~/inga-vault/00_theses/thesis-template.md    ~/inga-vault/00_theses/my-first-thesis.md

Open ~/inga-vault/00_theses/my-first-thesis.md in your editor. Update the frontmatter and body. For this tutorial, use the provided example thesis about RegTech:

# Or use the example thesis directly:
cp vault-template/examples/thesis-regtech-mittelstand.md    ~/inga-vault/00_theses/regtech-mittelstand.md

The example thesis targets German B2B software companies in regulatory technology with EPO patents or CORDIS grants.

Step 5: Run Flow A (10 minutes)

Start the 10-agent deal sourcing pipeline:

npx tsx src/cli/index.ts thesis source ~/inga-vault/00_theses/regtech-mittelstand.md

Claude Code spawns a team of 10 agents. You will see:

[orchestrator] Reading thesis: regtech-mittelstand.md
[thesis-parser] Extracting search criteria...
[discovery] Querying EPO (patents)...
[discovery] Querying CORDIS (grants)...
[discovery] Querying Offeneregister (companies)...
[entity-resolver] Deduplicating 847 raw hits...
[graph-writer] Writing 234 nodes to FalkorDB...
[qualifier] Scoring 234 candidates...
[dossier-writer] Writing dossier: acme-gmbh.md (score: 78)...
[dossier-writer] Writing dossier: beta-software-gmbh.md (score: 65)...
[path-finder] Finding warm intro paths...
[outreach-composer] Drafting messages for acme-gmbh...

After 8-15 minutes, check your inbox:

ls ~/inga-vault/10_pipeline/inbox/
# acme-gmbh.md  beta-software-gmbh.md  ...

You should see 5-10 deal dossiers.

Step 6: Review and Send (optional)

Open a dossier in your editor (or Obsidian):

cat ~/inga-vault/10_pipeline/inbox/acme-gmbh.md

The dossier contains:

  • Company snapshot (founding year, headcount, location)
  • Founder profiles
  • IP and funding history (from EPO and CORDIS)
  • Graph context (connected patents and grants)
  • Strategic fit assessment (qualify-score + strategic-fit)
  • Red flags
  • Warm-intro paths (if any were found)
  • Three outreach drafts (LinkedIn DM, cold email, warm intro ask)

To approve for outreach:

mv ~/inga-vault/10_pipeline/inbox/acme-gmbh.md    ~/inga-vault/10_pipeline/outbox/

To preview what would be sent:

npx tsx src/cli/index.ts email:send --dry-run

To send (requires Unipile and/or Instantly configured in .env.local):

npx tsx src/cli/index.ts email:send

Next Steps

You have completed your first deal flow. Next:

  1. Query the graph to explore discovered companies:

    npx tsx src/cli/index.ts ask "Which companies have both EPO patents and CORDIS grants?"

  2. Run the outreach engine without Flow A (if you have a list of companies):

    npx tsx src/cli/index.ts deals:qualify --source csv --input my-list.csv

  3. Configure providers for enrichment and outreach:

  4. Set up background agents to run daily:

    npx tsx src/cli/index.ts agent:create
npx tsx src/cli/index.ts agent:install --agent my-agent --hour 8 --minute 0

  5. Open the campaign dashboard:

    npx tsx src/cli/index.ts campaign:dashboard

Troubleshooting

"setup: command not found" or init/thesis missing

These commands ship in v0.5.0+. If they are not available, you are on an older build — run npm install && npm run typecheck to confirm the working tree is current. The outreach commands work independently of the Flow A vault flow.

FalkorDB connection refused

docker-compose ps falkordb
docker logs inga-falkordb --tail 30

See Setup FalkorDB for detailed troubleshooting.

thesis source hangs or produces 0 dossiers

  1. Check that your .env.local has a valid ANTHROPIC_API_KEY
  2. Confirm FalkorDB is running: docker-compose ps falkordb
  3. Try with the example thesis: vault-template/examples/thesis-regtech-mittelstand.md
  4. Check Claude Code logs for agent errors

Dossiers are empty or incomplete

The qualifier agent filters companies by score >= 60. If your thesis criteria are very narrow, fewer companies may qualify. Try broadening the criteria in your thesis file.

Related Docs