factorforge-cds 3.1.4

FactorForge - open-source constraint-based CDS design engine by Eijex.

FactorForge

Open-source constraint-based CDS design engine for Nicotiana benthamiana expression workflows.

FactorForge optimizes protein sequences into N. benthamiana-compatible CDS by maximizing CAI, controlling GC content, eliminating PolyA signals, and producing MoClo/Golden Gate-ready constructs.

→ Full Documentation

---

Quick Start

pip install factorforge-cds
factorforge optimize my_protein.fasta -o output.fasta

Or use the web app — no installation required.

---

Access Options

Method	Description	Link
Web App	No installation, demo & light use	factorforge-cds.vercel.app
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

---

Repository Structure

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.

---

Development History

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 — ML Research Track	Planned	Future ML re-attempt with improved data and architecture

The archive/ directory preserves all three earlier tracks for provenance. None are installed or exposed by the current package.

---

⚠️ Validation Status

FactorForge predictions are in-silico only and have not been experimentally validated in wet-lab conditions. See Validation and VALIDATION.md.

---

Citing

FactorForge v3.1.4 (2026). Open-source constraint-based CDS design engine.
Eijex. https://github.com/eijex/factorforge-cds

A citable publication is in preparation.

---

Contributors

	Name	Role
👤	Mun-Kyu Kim (@eijex)	Author & maintainer
🤖	Claude (Anthropic)	Design, analysis, planning
🤖	Codex (OpenAI)	Implementation

License

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.

---

Get in Touch

• Docs — eijex.github.io/factorforge-cds
• Wet-lab Results — Submit via Google Form (recommended) or GitHub Issue
• GitHub Issues — bugs, features: github.com/eijex/factorforge-cds/issues
• Email — [e-mail]
• Web — factorforge-cds.vercel.app