{"id":13588418,"url":"https://github.com/semanser/codel","last_synced_at":"2025-05-15T08:10:26.664Z","repository":{"id":229310790,"uuid":"773950709","full_name":"semanser/codel","owner":"semanser","description":"✨ Fully autonomous AI Agent that can perform complicated tasks and projects using terminal, browser, and editor.","archived":false,"fork":false,"pushed_at":"2024-04-29T17:53:58.000Z","size":16262,"stargazers_count":2302,"open_issues_count":27,"forks_count":184,"subscribers_count":27,"default_branch":"main","last_synced_at":"2025-04-14T12:18:39.221Z","etag":null,"topics":["agent","ai","autonomous-agents","bot","devin","llama2","llms","ollama","openai"],"latest_commit_sha":null,"homepage":"https://discord.gg/uMaGSHNjzc","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/semanser.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-18T17:21:32.000Z","updated_at":"2025-04-12T18:07:57.000Z","dependencies_parsed_at":"2024-07-27T19:05:23.734Z","dependency_job_id":"3ab1d17b-0aca-4c78-8e43-da561b469bee","html_url":"https://github.com/semanser/codel","commit_stats":{"total_commits":170,"total_committers":7,"mean_commits":"24.285714285714285","dds":0.04117647058823526,"last_synced_commit":"fe1e846c9e04f41209498ed0d88e92b15dcdfad2"},"previous_names":["semanser/codel"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semanser%2Fcodel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semanser%2Fcodel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semanser%2Fcodel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semanser%2Fcodel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/semanser","download_url":"https://codeload.github.com/semanser/codel/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248877968,"owners_count":21176244,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","ai","autonomous-agents","bot","devin","llama2","llms","ollama","openai"],"created_at":"2024-08-01T15:06:42.144Z","updated_at":"2025-04-14T12:18:56.648Z","avatar_url":"https://github.com/semanser.png","language":"TypeScript","funding_links":[],"categories":["HarmonyOS","TypeScript","Software Development","A01_文本生成_文本对话","App","Learning","🚀 AI Tools for Vim, Neovim, and Terminal","其他LLM框架","bot","Repos","Task Automation \u0026 Workflow Orchestration","Agent Categories","Other LLM Frameworks","Terminal-native coding agents"],"sub_categories":["Windows Manager","大语言对话模型及数据","Repositories","文章","AI Platform Configurators","\u003ca name=\"Unclassified\"\u003e\u003c/a\u003eUnclassified","Videos Playlists","Open Source"],"readme":"\u003cimg src=\"./.github/demo.png\" /\u003e\n\u003cdiv align=\"center\"\u003eFully autonomous AI Agent that can perform complicated tasks and projects using terminal, browser, and editor.\u003c/div\u003e\n\u003c/br\u003e\n\n**Discord: https://discord.gg/uMaGSHNjzc**\n\n# Features\n- 🔓 Secure. Everything is running in a sandboxed Docker environment.\n- 🤖 Autonomous. Automatically detects the next step and performs it.\n- 🔍 Built-in browser. Fetches latest information from the web (tutorials, docs, etc.) if needed.\n- 📙 Built-in text editor. View all the modified files right in your browser.\n- 🧠 All the history commands and outputs are saved in the PostgreSQL database.\n- 📦 Automatic Docker-image picker based on the user task.\n- 🤳 Self-hosted\n- 💅 Modern UI\n\n# Getting started\nThe simplest way to run Codel is to use a pre-built Docker image. You can find the latest image on the [Github Container Registry](https://github.com/semanser/codel/pkgs/container/codel).\n\n\n\u003e [!IMPORTANT]\n\u003e You need to use a corresponding environment variable in order to use any of the supported language models.\n\nYou can run the Docker image with the following command. Remove or change the environment variables according to your needs.\n```bash\ndocker run \\\n  -e OPEN_AI_KEY=your_open_ai_key \\\n  -e OPEN_AI_MODEL=gpt-4-0125-preview \\\n  -e OLLAMA_MODEL=llama2 \\\n  -p 3000:8080 \\\n  -v /var/run/docker.sock:/var/run/docker.sock \\\n  ghcr.io/semanser/codel:latest\n```\n\nAlternatively, you can create a `.env` file and run the Docker image with the `--env-file` flag. More information can be found [here](https://docs.docker.com/reference/cli/docker/container/run/#env)\n\nNow you can visit [localhost:3000](localhost:3000) in your browser and start using Codel.\n\n\u003cdetails\u003e\n    \u003csummary\u003eSupported environment variables\u003c/summary\u003e\n\n    * `OPEN_AI_KEY` - OpenAI API key. You can get the key [here](https://platform.openai.com/account/api-keys).\n    * `OPEN_AI_MODEL` - OpenAI model (default: gpt-4-0125-preview). The list of supported OpenAI models can be found [here](https://pkg.go.dev/github.com/sashabaranov/go-openai#pkg-constants).\n    * `OPEN_AI_SERVER_URL` - OpenAI server URL (default: https://api.openai.com/v1). Change this URL if you are using an OpenAI compatible server.\n    * `OLLAMA_MODEL` - locally hosted Ollama model (default: https://ollama.com/model). The list of supported Ollama models can be found [here](https://ollama.com/models).\n    * `OLLAMA_SERVER_URL` - Ollama server URL (default: https://host.docker.internal:11434). Change this URL if you are using an Ollama compatible server.\n    See backend [.env.example](./backend/.env.example) for more details.\n\n\u003c/details\u003e\n\n# Development\n\nCheck out the [DEVELOPMENT.md](./DEVELOPMENT.md) for more information.\n\n# Roadmap\n\nYou can find the project's roadmap [here](https://github.com/semanser/codel/milestones).\n\n# Credits\nThis project wouldn't be possible without:\n- https://arxiv.org/abs/2308.00352\n- https://arxiv.org/abs/2403.08299\n- https://www.cognition-labs.com/introducing-devin\n- https://github.com/go-rod/rod\n- https://github.com/semanser/JsonGenius\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsemanser%2Fcodel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsemanser%2Fcodel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsemanser%2Fcodel/lists"}