Open-source constraint-based CDS design engine for sequence-level CDS design, with primary support for Nicotiana benthamiana (Tobacco BY-2: experimental).
FactorForge performs profile-guided CDS design with CAI/GC metrics, PolyA-signal screening, and Golden Gate/MoClo-aware checks. Primary support: N. benthamiana (agroinfiltration). Experimental host context: Tobacco BY-2 (--host by2).
pip install factorforge-cds
factorforge optimize my_protein.fasta -o output.fastaOr use the web app — no installation required.
| Method | Description | Link |
|---|---|---|
| Web App | No installation, demo & light use | factorforge.eijex.com |
| CLI / Python | Local use, batch processing, data privacy | pip install factorforge-cds |
| Docker | Full web interface locally | docker pull ghcr.io/eijex/factorforge-cds:latest |
| Eijex MCP | AI agent access (Claude Code, Cursor) | mcp.eijex.com |
The supported production engine is the deterministic profile engine under:
src/factorforge/engines/profile/
Historical implementation tracks are preserved under archive/ for provenance
and are not imported by the installed package or exposed as supported engines.
FactorForge has gone through several implementation generations before the current public release:
| Generation | Status | Description |
|---|---|---|
| v1 — NBent_OptiCodon | Internal | Thesis-derived codon optimization baseline for N. benthamiana |
| v2 — Rule-Based Engine | Internal → Production | Deterministic, constraint-aware design engine; became the foundation for the public release |
| v3-alpha — ML Prototype | Archived | ML-based design attempt; performance was insufficient for production use; preserved under archive/v3-ml-prototype/ |
| v3.0+ — Current release | Public | Open-source release of the matured v2 engine under factorforge.engines.profile |
| v4.0 — ML Engine | Planned | ML-based design as --engine ml; added once sufficient wet-lab data is available |
The archive/ directory preserves all three earlier tracks for provenance. None are installed or exposed by the current package.
FactorForge predictions are in-silico only and have not been experimentally validated in wet-lab conditions. See Validation and VALIDATION.md.
FactorForge v3.1.9 (2026). Open-source constraint-based CDS design engine.
Eijex. https://github.com/eijex/factorforge-cds
| Name | Role | |
|---|---|---|
| 👤 | Mun-Kyu Kim (@eijex) | Author & maintainer |
| 🤖 | Claude (Anthropic) | Design, analysis, planning |
| 🤖 | Codex (OpenAI) | Implementation |
GNU Affero General Public License v3.0 — see LICENSE.
Disclaimer: FactorForge is provided for research purposes only. Predictions are computational and have not been experimentally validated.
- Docs — eijex.github.io/factorforge-cds
- Wet-lab Results — Public-safe validation summaries are welcome. Do not submit raw sequences, confidential construct details, internal batch IDs, patient data, private contact information, exact process parameters, or confidential partner/customer data. See VALIDATION.md before submitting.
- GitHub Issues — bugs, features: github.com/eijex/factorforge-cds/issues
- Email — eijex.lab@gmail.com
- FactorForge — factorforge.eijex.com
- Lab — www.eijex.com