{"id":31742858,"url":"https://github.com/timescale/tiger-eon","last_synced_at":"2026-05-19T14:04:32.716Z","repository":{"id":317310098,"uuid":"1066793656","full_name":"timescale/tiger-eon","owner":"timescale","description":"An LLM-powered Slack bot for your internal knowledge, powered by tiger-agents-for-work libraries.","archived":false,"fork":false,"pushed_at":"2025-12-22T16:46:51.000Z","size":2164,"stargazers_count":111,"open_issues_count":2,"forks_count":8,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-28T15:38:37.525Z","etag":null,"topics":["llm","slack"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/timescale.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,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-30T01:13:47.000Z","updated_at":"2026-03-28T12:14:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"3adf408f-a6ab-4a3c-a1cd-754a72409d68","html_url":"https://github.com/timescale/tiger-eon","commit_stats":null,"previous_names":["timescale/tiger-eon"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/timescale/tiger-eon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timescale%2Ftiger-eon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timescale%2Ftiger-eon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timescale%2Ftiger-eon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timescale%2Ftiger-eon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/timescale","download_url":"https://codeload.github.com/timescale/tiger-eon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timescale%2Ftiger-eon/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33219393,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-19T07:54:09.561Z","status":"ssl_error","status_checked_at":"2026-05-19T07:54:08.508Z","response_time":58,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["llm","slack"],"created_at":"2025-10-09T11:19:01.800Z","updated_at":"2026-05-19T14:04:32.710Z","avatar_url":"https://github.com/timescale.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# Eon — Your Internal Slack Agent\n\nYour business already has the answers — in Slack threads, GitHub pull requests, Linear tasks, your docs, and Salesforce service tickets. But those answers are scattered, hard to find, and often forgotten.\n\n**Eon brings them back to the surface.**\n\nAsk a question in Slack:\n- \"What did we ship last week?\"\n- \"What's blocking the release?\"\n- \"Summarize the latest GitHub pull requests.\"\n\nEon responds instantly, pulling from the tools you already use. No new UI, no new workflow — just answers in Slack, where your team already works.\n\n---\n\n## Why Eon?\n\n- **Unlock hidden value**: Your Slack, GitHub, and Linear data already contain the insights you need. Eon makes them accessible.\n- **Faster decisions**: Instead of searching or asking around, your team can get answers in seconds.\n- **Easy to run**: The agent and MCP servers run statelessly in your own infrastructure, lightweight and simple to deploy.\n- **Seamless with Tiger**: Eon uses a Tiger Postgres service (starting with a free plan). Prefer to self-host? Any Postgres instance with TimescaleDB works.\n- **Grows with you**: Start with Slack and GitHub today. Add docs, Salesforce, and more tomorrow.\n\n---\n\n## What Eon Can Do\n\n**Available now**\n- **Slack** — Ask questions, and Eon searches your company's public conversations and history to find the answers\n- **GitHub (optional)** — Summarize pull requests, issues, and activity\n- **Linear (optional)** — Stay on top of project tasks and issues\n\n**Coming soon**\n- **Docs** — Search and summarize company knowledge\n- **Salesforce** — Surface customer updates, opportunities, and account insights\n\n---\n\n# Demo\n\n## Track Latest Project Developments\n\nStay up-to-date with what's happening across your projects and team members with intelligent progress tracking.\n\n![Screenshot displaying EON's progress tracking interface showing recent project developments and team member activity insights](./images/slack-synthesize.png)\n\n*Get comprehensive insights into recent developments, and cross-platform project updates.*\n\n## Understand Technical Changes via the Github integration\n\n![Screenshot of EON analyzing GitHub code changes and providing technical insights about project modifications and pull requests](./images/github-mcp.png)\n\n*Analyze technical changes, review code modifications, and understand the evolution of your projects.*\n\n# Setup\n\n## Requirements\n\n* [git](https://git-scm.com/)\n* [Docker](https://www.docker.com/)\n* Accounts on:\n  * [Slack](https://slack.com/)\n  * [GitHub](https://github.com/) (Optional)\n  * [Anthropic](https://www.anthropic.com/)\n\n## Interactive Setup (Recommended)\n\n``` bash\ngit clone git@github.com:timescale/tiger-eon.git\ncd tiger-eon\n./setup\n```\n\n## Manual Setup\n\n```bash\ngit clone git@github.com:timescale/tiger-eon.git\ncd tiger-eon\ncp .env.sample .env\ncp mcp_config.json.sample mcp_config.json\n```\n\n### Setup Anthropic Token\n\n1. Go to https://console.anthropic.com/settings/keys\n2. Click \"Create Key\" and give it a workspace and name\n3. Copy the value into `.env` where it says `ANTHROPIC_API_KEY`\n\n### Setup GitHub token\n\n1. Go to https://github.com/settings/tokens/new?description=Tiger%20Agent\u0026scopes=repo,read:org\n2. Change the token name, set expiration date, and then hit \"Generate token\"\n3. Copy the value into `.env` where it says `GITHUB_TOKEN`\n4. Set the `GITHUB_ORG` value in `.env` to your GitHub organization (e.g. if https://github.com/timescale was your org page, then set `GITHUB_ORG=timescale`).\n\n### Setup Slack Ingest/MCP\n\n1. Go to https://api.slack.com/apps/\n2. Hit \"Create New App\" and select \"From a manifest\"\n3. Select your org's workspace to install the org into\n4. Copy https://raw.githubusercontent.com/timescale/tiger-slack/refs/heads/main/slack-app-manifest.json into the JSON input, changing the `display_information.name` and `features.bot_user.name` fields as needed\n5. Click \"Next\" and then \"Create\" buttons\n6. Scroll down on the page to \"App-Level Tokens\" and click \"Generate Token and Scopes\"\n7. Give it a name and set the `connections:write` scope.\n8. Copy the token into `.env` where it says `SLACK_INGEST_APP_TOKEN`\n9. Click \"Install App\" on the left sidebar, and the click \"Install to ...\" button on this page\n10. Grant the necessary permission and advance to the next page\n11. Copy the \"Bot User OAuth Token\" (starts with `xoxb-`) into `.env` file where it says `SLACK_INGEST_BOT_TOKEN`\n\n### Setup Slack Agent\n\nFollow the steps for seting up Slack Ingest/MCP, except:\n\n* For step (4), use https://raw.githubusercontent.com/timescale/tiger-agents-for-work/refs/heads/main/slack-manifest.json instead, changing the same fields as needed for the name.\n* For step (8), set the token to `SLACK_AGENT_APP_TOKEN`\n* For step (11), set the token to `SLACK_AGENT_BOT_TOKEN`\n\n### Setup Logfire (Optional)\n\n1. Log into https://logfire.pydantic.dev/login (set region as necessary)\n2. Under \"Projects\", click \"New project\"\n3. Give it a name and hit \"Create\"\n4. On next page, click \"Generate Write Token\"\n5. Copy that into the `.env` file under `LOGFIRE_TOKEN`\n\n## Start Services\n\nTo start configured services (based on COMPOSE_PROFILES in .env):\n\n```bash\ndocker compose up -d\n```\n\n## Customize\n\nYou can customize the MCP servers by [editing a configuration file](/docs/mcp-config.md). To modify the system or user prompts, [edit the Jinja2 templates](/docs/prompts.md).\n\n## Import Slack Data\n\nTo make the Slack MCP server more powerful, you can also restore a dump of your slack data, allowing eon to answer questions about historical\nthreads or channels, and not just from when it was setup. To do so:\n\n1. Follow the [Slack Docs](https://slack.com/help/articles/201658943-Export-your-workspace-data) on getting an export of your workspace\n2. Download the zip to your computer, and unzip it\n3. Run `./import-slack.sh \u003cpath/to/slack/export\u003e` replacing the argument with the actual path to your dump.\n\n# High-Level Architecture\n\nEon leverages the [tiger-agents-for-work](https://github.com/timescale/tiger-agents-for-work) library, which provides Slack event handling with robust event queuing/retrying and TimescaleDB-powered event history.\n\n```mermaid\ngraph TB\n    %% slack app mention @eon\n    U[Slack App Mention @agent]\n\n    %% Main Orchestrator\n    E[eon Agent]\n\n    %% External Services (via MCP)\n    GH[GitHub MCP]\n    SL[Slack MCP]\n\n    %% Flow\n    U --\u003e E\n\n    E --\u003e GH\n    E --\u003e SL\n\n    %% Link to tiger-agent repository\n    click H \"https://github.com/timescale/tiger-agent\"\n\n    %% Links to MCP server repositories\n    click GH \"https://github.com/timescale/tiger-gh-mcp-server\"\n    click SL \"https://github.com/timescale/tiger-slack\"\n```\n\n* Agent + MCP servers — run statelessly in your infrastructure, easy to deploy and scale.\n* Postgres — state. Use Tiger (with free plans) for seamless setup, or self-host Postgres if you prefer.\n* MCP servers — connect to Slack history, GitHub.\n\n# Contributing\n\nEon is open source under the Apache 2.0 license.\nContributions welcome — file issues or PRs in GitHub Issues.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimescale%2Ftiger-eon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimescale%2Ftiger-eon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimescale%2Ftiger-eon/lists"}