What do you want to do?
3 use cases
-
Send approved email sequences to a list of researched accounts
Import a CSV of accounts with one sourced observation each and let Franco send your signed-off sequence word for word.
- REPO
GortexAI/franco - Sales and marketing
- Intermediate
View prompt
Set up GortexAI/franco in approved copy mode: create the home folder, add my campaign <steps> to franco.local.yaml, validate <accounts.csv> with a dry run and stop before anything is sent so I can review the preview.
- REPO
-
Import your contact and do-not-contact lists from CSV
Bring existing spreadsheets into Franco and make sure suppressed addresses and domains are never emailed.
- REPO
GortexAI/franco - Sales and marketing
- Beginner
View prompt
Import <contacts.csv> into GortexAI/franco as contacts with a dry run first, report every rejected row and its reason, then load <do_not_contact.csv> as suppressions before importing for real.
- REPO
-
Run Franco from the published container image
Use the prebuilt image that already includes Chromium and the Claude CLI instead of a local Python install.
- REPO
GortexAI/franco - Sales and marketing
- Intermediate
View prompt
Deploy GortexAI/franco with the published ghcr.io image and docker compose on <server>, mount ./data, .env and my config, verify the image attestation, and confirm the dashboard loads.
- REPO
Quick start with Franco
- Check you have what it needs: Python 3.11 or newer; Claude Code logged in on a Pro or Max plan, or an opt-in Codex runtime on a ChatGPT plan; A mailbox to send from (Google Workspace recommended) and email verifier keys.
- Open GortexAI/franco on GitHub and read the README and license.
- Install with
pipx install franco, then runfranco init ~/franco && cd ~/franco - Set outreach mode to templates in Franco.local.yaml and define your campaign steps with the merge fields
- Run
franco import --template --kind accounts > accounts.csvand fill in one row per account - Check the file with
franco import accounts.csv --dry-run, then import it
These steps come from our top use case, Send approved email sequences to a list of researched accounts, which also has a copy-paste agent prompt.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for GortexAI/franco
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeAbout this repo
- Who it is forFounders and small sales teams who run outbound email and want it automated locally without a model API bill.
- Why it is hot899 stars, launched 16 days ago, talked about in 3 AI sources we track
- LanguagePython
- Sourcegithub.com/GortexAI/franco · Back to Hot repos
Requirements
- Python 3.11 or newer
- Claude Code logged in on a Pro or Max plan, or an opt-in Codex runtime on a ChatGPT plan
- A mailbox to send from (Google Workspace recommended) and email verifier keys
- Chromium, installed with franco install, for LinkedIn and JavaScript-heavy sites
Add this badge to your README
Maintain Franco? Show readers where to find these use cases.
Markdown
[](https://dedupedai.com/use-cases/gortexai-franco/?utm_source=github&utm_medium=badge&utm_campaign=GortexAI-franco)
HTML
<a href="https://dedupedai.com/use-cases/gortexai-franco/?utm_source=github&utm_medium=badge&utm_campaign=GortexAI-franco"><img src="https://dedupedai.com/badge/GortexAI/franco.svg" alt="Use cases on Deduped" height="20"></a>
A static image, no tracking script. About the badge
Questions about Franco
What is Franco?
Franco is an outbound sales agent that runs on your own machine and uses the Claude Code or Codex subscription you already pay for. It works through a list of accounts, sends short email sequences from your own mailbox, reads replies and handles them. It has three modes: generated outreach, approved copy sent word for word, and Raad funnels. It is an open-source project on GitHub: https://github.com/GortexAI/franco.
How do I use Franco?
Install with pipx install franco, then run franco init ~/franco && cd ~/franco; then set outreach mode to templates in Franco.local.yaml and define your campaign steps with the merge fields; run franco import --template --kind accounts > accounts.csv and fill in one row per account. The use cases on this page give the full steps and a copy-paste agent prompt for each job.
Who is Franco for?
Founders and small sales teams who run outbound email and want it automated locally without a model API bill.
What can I do with Franco?
3 use cases so far, for example: Send approved email sequences to a list of researched accounts; Import your contact and do-not-contact lists from CSV; Run Franco from the published container image. Each has steps and a copy-paste agent prompt.
What do I need to run Franco?
Python 3.11 or newer; Claude Code logged in on a Pro or Max plan, or an opt-in Codex runtime on a ChatGPT plan; A mailbox to send from (Google Workspace recommended) and email verifier keys; Chromium, installed with franco install, for LinkedIn and JavaScript-heavy sites.
What are alternatives to Franco?
Other hot AI repos in Sales and marketing: Open SEO, TLive Omni, Claude SEO, Social Media Research Skills, Codflow.
Is Franco safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.