reyuyu/ccfa-gent

CCFA Paper Agent is a local AI writing workspace designed to help researchers write, check, and revise academic papers, particularly those targeting CCF-A conferences and SCI journals. It runs entirely on your own machine using a React web interface backed by a Python API server. The system organizes each paper as a project that holds your draft files, reference papers, figures, and notes about the scientific problem you are addressing. Rather than a single chatbot, it routes your requests to specialized agents depending on what you need: one agent handles writing and revision, another reviews your manuscript for logical and structural problems, a third searches academic literature on Semantic Scholar to find supporting papers, and a coordinator decides which specialist to call. A notable design choice is that no file on your machine is edited without your approval. When any agent proposes a change to your manuscript, it generates a diff that you can inspect in the browser before accepting or rejecting it. This means you can run the AI freely without worrying about it silently overwriting your work. Other features include PDF parsing via a tool called MinerU that converts reference papers into clean Markdown, a phrase memory that accumulates useful academic sentence patterns across sessions, and streaming output so you can watch the agents' reasoning steps in real time. Setup requires Python 3.10 or newer, Node.js 20, and a DeepSeek API key to power the agents. A Semantic Scholar API key is optional but improves rate limits for literature search. Running the provided startup script installs dependencies and opens the workspace in your browser at a local address. Chrome or Edge are recommended because the app uses browser file-system features that Safari does not fully support.