Skip to content
View codegeist-ai's full-sized avatar
🚧
Building Codegeist in public
🚧
Building Codegeist in public

Block or report codegeist-ai

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
codegeist-ai/README.md

Codegeist AI

Open source sets us free.

Website GitHub Hugging Face

X LinkedIn YouTube Discord

Codegeist AI is an open-source project family building practical AI systems and the reproducible tooling behind them. Codegeist is the coding agent. Codegeist OS and Codegeist LLM explore a more local, inspectable, and deliberately separated AI stack.

The projects are at different stages. The coding agent is usable early-stage software; Codegeist LLM publishes narrow research artifacts; Codegeist OS is currently architecture and research, not a released operating system.

Start Here

Goal Destination
Use or contribute to the coding agent codegeist
Explore the operating-system architecture codegeist-os
Follow local-model research and artifacts codegeist-llm and Hugging Face
Follow current priorities Public roadmap
Read the contribution workflow Contributing guide
Ask for quick help Discord developer community

Primary Projects

Project Current role Status
codegeist Open-source Java coding agent with CLI/TUI workflows, tools, MCP, local and hosted model support, and native releases Early-stage software
codegeist-os AI-focused operating-system architecture built around explicit identities, policy, isolation, and recovery Architecture and research
codegeist-llm Compact local-model research, provenance, evaluation, and reproducible artifact work Early research and artifacts

These projects do not yet form a completed integrated stack. Their repositories separate current evidence from planned architecture and publish progress in the open.

Supporting Infrastructure

Open Development

  • Source, project planning, Issues, releases, and durable technical decisions live on GitHub.
  • Public model profiles and reviewed model artifacts are discoverable through huggingface.co/codegeist.
  • Discord supports quick help, feedback, and workflow sharing; decisions that need to last move back into repositories and documentation.
  • Claims should identify whether they describe released software, an experiment, or intended architecture.

Contributing

  1. Choose the repository that owns the change.
  2. Read its local guidance and find or open a focused Issue.
  3. Work in a small branch or fork and run the documented check.
  4. Open a pull request that links the Issue and any applicable local task.

The account-wide contribution guide applies unless a repository provides more specific instructions. General support routes are documented in the support guide, and vulnerabilities belong in the security process.

Canonical repository checks
Repository Check
codegeist task cli:check
codegeist-agent-kit task test
codegeist-devcontainer-kit task check
.github bash scripts/check.sh
codegeist-ai/codegeist-ai bash scripts/check.sh

Account Model

codegeist-ai is currently a personal GitHub account used only as the public Codegeist AI brand account. It is not a GitHub organization. The codegeist-ai/codegeist-ai repository renders this profile, while .github owns account-wide community defaults. The complete ownership and release model is documented in GITHUB_ACCOUNT_MODEL.md.

Codegeist-owned profile material is available under the 0BSD license.

Pinned Loading

  1. codegeist codegeist Public

    Open source Java coding agent for CLI and TUI workflows, MCP tools, local models, and native releases

    Java

  2. codegeist-agent-kit codegeist-agent-kit Public

    Shared OpenCode rules, commands, skills, integrations, and generated workspace releases

    Shell

  3. codegeist-devcontainer-kit codegeist-devcontainer-kit Public

    Shared reproducible devcontainer source and generated consumer releases for Codegeist projects

    Shell

  4. codegeist-os codegeist-os Public

    AI-focused Linux distribution research with a least-privilege AI user

    Dockerfile

  5. codegeist-llm codegeist-llm Public

    Compact language model research for consumer hardware and Codegeist OS

    Python

  6. .github .github Public

    Shared Codegeist community health files and contributor defaults

    Shell