nocodo

의견이 강한(opinionated), 에이전트가 활성화된(agent-enabled) 풀스택 애플리케이션 엔진입니다. 만들고 싶은 것(비즈니스 자동화, 개인 재정 관리, 프로젝트 관리 등)을 말하면 바로 사용할 수 있는 소프트웨어를 얻게 됩니다. Rust, SQLite, SolidJS로 구축되었습니다.

매우 초기 단계. nocodo는 완성된 제품이 아니라 실험입니다. 오늘날 그것은 한 가지 일만 합니다: 일반 언어 설명(plain-language description)을 실제 데이터베이스 설계(저장 계층)로 변환하고 그 데이터베이스를 구축해 줍니다. 가져오기, 규칙, 보고서 및 완성된 앱 UI는 나중에 추가됩니다. 거친 부분과 버전 간의 변경 사항이 있을 것으로 예상하십시오.

오늘 할 수 있는 것

자신만의 말로 추적하고 싶은 것을 설명합니다:

우리 가족 돈에 관심을 갖고 싶어요. 제 월급은 매달 들어오고, 가계에 지출하며, 때로는 남동생에게 돈을 빌려줍니다. 저희는 두 개의 은행 계좌가 있어요.

nocodo는 다음과 같이 작동합니다:

1. 몇 가지 질문을 합니다 (한 라운드당 최대 8개). 각 질문은 번호가 매겨진 선택지와 제안된 기본값을 가집니다. 기술 용어는 전혀 없습니다: 테이블, 키 또는 SQL에 대해 질문받지 않습니다.
2. 데이터를 단순한 메모 더미가 아닌 적절한 관계형 SQLite 데이터베이스로 저장 설계를 합니다.
3. 아무것도 건드리기 전에 자체적으로 검사합니다: 먼저 데이터 복사본에서 변경 사항을 테스트 실행합니다.
4. 데이터를 백업한 다음 data.sqlite에 변경 사항을 적용합니다.
5. 도구가 이제 무엇을 기억하게 될지 일반 언어로 알려줍니다.

나중에 더 많은 것을 요청할 수 있습니다(

시작하기 전에: 모델 키

nocodo는 AI 모델을 사용하여 사용자의 설명을 이해합니다. 사용자가 직접 API 키를 가져와야 합니다. nocodo를 실행하는 폴더에 .env라는 파일을 생성하고, 사용하는 제공업체의 키를 추가하세요. 예를 들면 다음과 같습니다:

ANTHROPIC_API_KEY=your-key-here

지원되는 변수: ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, OPENROUTER_API_KEY, DEEPSEEK_API_KEY, NEURALWATT_API_KEY. llama.cpp를 통한 로컬 모델은 키가 필요 없습니다. 각 프로젝트가 어떤 제공업체와 모델을 사용하는지는 project.json에 설정되어 있습니다.

AI는 디자인만 제안합니다. SQL을 작성하거나 데이터를 직접 건드리는 일은 절대 하지 않습니다. 일반적이고 예측 가능한 코드가 그 역할을 합니다.

창 사용하기

1. nocodo-gui를 시작합니다.
2. **새 프로젝트...**를 선택하고 이름을 지정합니다.
3. 프롬프트 상자에 추적하고 싶은 내용을 입력합니다.
4. 나타나는 질문에 답변하거나 기본값 사용을 클릭합니다.
5. 메인 영역에서 요약 및 테이블을 확인합니다. 샘플 행 추가를 누르면 가짜 행으로 채워져서 어떻게 보일지 확인할 수 있습니다.

명령줄 사용하기

# 프로젝트 생성
nocodo init --project my-money

...

모델 호출이 실패하면, nocodo continue --project my-money를 실행하여 재시도할 수 있습니다. --project 반복을 건너뛰려면 NOCODO_PROJECT를 설정하세요.

프로젝트 내부 구성 요소

프로젝트는 단순히 폴더입니다:

• data.sqlite: 사용자의 데이터로, 모든 SQLite 도구로 열어볼 수 있는 표준 SQLite 파일입니다.
• specs/schema.json: 사용자 데이터의 설계도입니다.
• migrations/: 디자인에 대해 이루어진 모든 변경 사항이 평문 SQL 형태로 저장됩니다.
• backups/: 각 변경 전의 데이터 사본입니다.
• events.jsonl: 발생한 모든 일과 그 이유가 읽기 쉬운 기록으로 남아 있습니다.

현재 제한 사항

• 스토리지만 지원: 파일, 규칙 또는 보고서 가져오기는 아직 불가능합니다.
• 한 명의 사용자, 단일 기기에서 사용 가능. 계정, 클라우드, 창 내 행 편집 기능은 아직 없습니다.
• SQLite만 지원합니다.
• 프로젝트는 한 번에 하나의 변경 사항만 수용할 수 있습니다.

작동 방식 (간단 버전)

nocodo는 작고 집중된 에이전트들을 사용하며, 각 에이전트는 하나의 작업을 맡아 **코드가 아닌 타입 지정 사양(typed specs)**을 생성합니다. 결정론적 Rust 코드는 이 사양을 실제 아티팩트(예: SQL 마이그레이션)로 변환하고, 미리 구축된 런타임이 이를 실행합니다. 이것이 동일한 요청에 대해 예측 가능한 결과가 나오는 이유이며, 개발자 도구 체인이 필요 없는 이유입니다.

• PRD.md: 현재 실험에서 테스트하는 내용과 그 이유.
• AGENTS.md: 기여자 및 코딩 에이전트를 위한 규칙 및 크레이트 경계.
• epics/: 단계별 빌드 계획.

라이선스

GNU Affero General Public License v3.0. LICENSE 참조.