{ "markdown": "

\n \n \"Kaneo's\n \n

\n\n
\n\n[![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/usekaneo/kaneo/ci.yml?branch=main)](https://github.com/usekaneo/kaneo/actions)\n[![Discord](https://img.shields.io/discord/1326250681530843178?color=7389D8&label=&logo=discord&logoColor=ffffff)](https://discord.gg/rU4tSyhXXU)\n[![Sponsors](https://img.shields.io/github/sponsors/andrejsshell)](https://github.com/sponsors/andrejsshell)\n\n
\n\n
\n

\n Quick Start\n | \n Website\n | \n Cloud\n | \n Discord\n

\n
\n\n\n

\n \"Kaneo\n

\n\n## Why Kaneo?\n\nAfter years of using bloated, overcomplicated project management platforms that distracted from actual work, we built Kaneo to be different.\n\nThe problem with most tools isn't that they lack features, it's that they have **too many**. Every notification, every unnecessary button, every complex workflow pulls your team away from what matters: **building great products**.\n\nWe believe the best tools are **invisible**. They should amplify your team's natural workflow, not force you to adapt to theirs. Kaneo is built on the principle that **less is more**: every feature exists because it solves a real problem, not because it looks impressive in a demo.\n\n**What makes it different:**\n- **Clean interface** that focuses on your work, not the tool\n- **Self-hosted** so your data stays yours\n- **Actually fast** because we care about performance\n- **Open source** with a permissive MIT license\n\nLearn more about Kaneo's features and capabilities in our [documentation](https://kaneo.app/docs/core).\n\n## Sponsors\n\nKaneo is open source. If you find it useful, consider [sponsoring the project](https://github.com/sponsors/andrejsshell) to help support ongoing development.\n\n\"User\"User\"User\n\n## Getting Started\n\n### One-Click Deployment with drim\n\nFor straightforward deployments, use [drim](https://github.com/usekaneo/drim) - a CLI tool that handles everything for you:\n\n```bash\ncurl -fsSL https://assets.kaneo.app/install.sh | sh\ndrim setup\n```\n\nThat's it. Your Kaneo instance will be running with automatic HTTPS, database setup, and all services configured.\n\nPerfect for quick deployments and production setups where you want things to just work.\n\n### Quick Start with Docker Compose\n\nThe fastest way to try Kaneo is with Docker Compose. This sets up Kaneo and PostgreSQL with a single Kaneo container:\n\n```yaml\nservices:\n postgres:\n image: postgres:16-alpine\n env_file:\n - .env\n ports:\n - \"5432:5432\"\n volumes:\n - postgres_data:/var/lib/postgresql/data\n restart: unless-stopped\n healthcheck:\n test: [\"CMD-SHELL\", \"pg_isready -U kaneo -d kaneo\"]\n interval: 10s\n timeout: 5s\n retries: 5\n\n kaneo:\n image: ghcr.io/usekaneo/kaneo:latest\n ports:\n - \"5173:5173\"\n env_file:\n - .env\n depends_on:\n postgres:\n condition: service_healthy\n restart: unless-stopped\n\nvolumes:\n postgres_data:\n```\n\nSave this as `compose.yml`, copy `.env.sample` to `.env`, uncomment `KANEO_CLIENT_URL=http://localhost:5173`, and set `POSTGRES_PASSWORD=` and `AUTH_SECRET=`, run `docker compose up -d`, and open [http://localhost:5173](http://localhost:5173).\n\nIn Docker Compose, the bundled Kaneo container reaches PostgreSQL at the service hostname `postgres`.\nIf you run the API on your host instead of inside Compose, use `localhost` or set `DATABASE_URL` explicitly.\n\n> **Important:** See our [full documentation](https://kaneo.app/docs/core) for detailed setup instructions, environment variable configuration, and troubleshooting guides.\n\n### Deploy on Coolify\n\nKaneo ships a [Coolify-optimized `compose.coolify.yml`](compose.coolify.yml). In Coolify, create a **Public Repository** resource pointing to `https://github.com/usekaneo/kaneo`, pick the **Docker Compose** build pack (Base Directory `/`, Compose Location `compose.coolify.yml`), assign a domain to the `kaneo` service as `https://your-domain.com:5173`, set `KANEO_CLIENT_URL`, and deploy. `AUTH_SECRET` and the database password are auto-generated by Coolify. Leave `KANEO_API_URL` unset (it is derived from `KANEO_CLIENT_URL`; a `localhost` value breaks the browser API calls). See the [Coolify deployment guide](https://kaneo.app/docs/core/deployments/coolify) for details.\n\n### Development Setup\n\nFor development, see our [Environment Setup Guide](ENVIRONMENT_SETUP.md) for detailed instructions on configuring environment variables and troubleshooting common issues like CORS problems.\n\n### Configuration\n\nKaneo requires several environment variables to be configured. The Docker Compose setup above handles the database automatically, but you'll need to configure environment variables for the API and web services.\n\nFor complete configuration instructions, including all required environment variables, database setup for non-Docker deployments, and advanced settings, see the [documentation](https://kaneo.app/docs/core). Advanced deployments can still use the separate `ghcr.io/usekaneo/api` and `ghcr.io/usekaneo/web` images.\n\n## Kubernetes Deployment\n\nIf you're running Kubernetes, we provide a comprehensive Helm chart. Check out the [Helm chart documentation](./charts/kaneo/README.md) for detailed installation instructions, production configuration examples, TLS setup, and more.\n\n## Development\n\nWant to hack on Kaneo? See our [Environment Setup Guide](ENVIRONMENT_SETUP.md) for detailed instructions on configuring environment variables and troubleshooting common issues like CORS problems.\n\nQuick start:\n```bash\n# Clone and install dependencies\ngit clone https://github.com/usekaneo/kaneo.git\ncd kaneo\npnpm install\n\n# Create a .env file in the root with required environment variables\n# See ENVIRONMENT_SETUP.md for detailed instructions\n\n# Start development servers\npnpm dev\n```\n\nFor contributing guidelines, code structure, and development best practices, check out our [contributing guide](CONTRIBUTING.md) and [documentation](https://kaneo.app/docs/core).\n\n## MCP Server\n\nKaneo has an official [MCP (Model Context Protocol) server](https://kaneo.app/docs/core/integrations/mcp), so AI tools like Claude, Cursor, and other MCP clients can manage your tasks, projects, and labels. Every instance ships a built-in HTTP MCP endpoint at `/api/mcp`, and for stdio clients there is the official [@kaneo/mcp](https://www.npmjs.com/package/@kaneo/mcp) package on npm (`npx -y @kaneo/mcp`).\n\n## Community\n\n- **[Discord](https://discord.gg/rU4tSyhXXU)** - Chat with users and contributors\n- **[GitHub Issues](https://github.com/usekaneo/kaneo/issues)** - Bug reports and feature requests\n- **[Documentation](https://kaneo.app/docs/core)** - Detailed guides, API docs, and tutorials\n\n## Contributing\n\nWe're always looking for help, whether that's:\n- Reporting bugs or suggesting features\n- Improving documentation\n- Contributing code\n- Helping other users on Discord\n\nCheck out [CONTRIBUTING.md](CONTRIBUTING.md) for the details on how to get involved.\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n---\n\n
\n \"Repobeats\n
\n\n

\n Built with ❤️ by the Kaneo team and contributors\n

\n", "bytes": 8352, "sha": "ff2911d20d4f420cd8af1aa58f8e19727fda41146293a0566f9f1ec3d109a20d", "repo_slug": "usekaneo/kaneo", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_usekaneo_kaneo_7e15cb08/readme" }