{"data":{"slug":"longevity-genie-just-chat","name":"just-chat","tagline":"Make your LLM agent and chat with it simple and fast!","github_url":"https://github.com/longevity-genie/just-chat","owner":"longevity-genie","repo":"just-chat","owner_avatar_url":"https://avatars.githubusercontent.com/u/136511203?v=4","primary_language":"Python","stars":74,"forks":13,"topics":["agentic-ai","agents","ai","chat","chatbot","deepseek","groq","llama","llms"],"archived":false,"github_pushed_at":"2025-11-22T13:41:23+00:00","maintenance_label":"Slowing","url":"https://www.graphcanon.com/tools/longevity-genie-just-chat","markdown_url":"https://www.graphcanon.com/tools/longevity-genie-just-chat.md","api_url":"https://www.graphcanon.com/api/graphcanon/tools/longevity-genie-just-chat","graph_url":"https://www.graphcanon.com/api/graphcanon/graph?tool=longevity-genie-just-chat","description":"Make your LLM agent and chat with it simple and fast!","homepage_url":null,"license":"Apache-2.0","open_issues":2,"watchers":2,"ai_summary":"A framework for quickly setting up and chatting with an LLM-based AI agent using Docker or Podman.","readme_excerpt":"## Quick start\n\nJust clone repository and run docker-compose!\n```bash\ngit clone git@github.com:longevity-genie/just-chat.git\nUSER_ID=$(id -u) GROUP_ID=$(id -g) docker-compose up\n```\nAnd the chat with your agent is ready to go! Open `http://localhost:3000` in your browser and start chatting with your agent!\nNote: container will be started with the user and group of the host machine to avoid permission issues. If you want to change this, you can modify the `USER_ID` and `GROUP_ID` variables in the `docker-compose.yml` file.\n\nIf you prefer Podman or use RPM-based distro where it is the default option, you can use alternative Podman installation:\n```bash\ngit clone git@github.com:longevity-genie/just-chat.git\npodman-compose up \n```\nUnlike Docker, Podman is rootless-by-design maps user and group id automatically. \nNB! Ubuntu 22 contains podman v.3 which is not fully compatible with this setup, assume podman v4.9.3 or higher is required.\n\n\n\nYou can customize your setup by:\n1. Editing `chat_agent_profiles.yaml` to customize your agent\n2. Adding tools to `/agent_tools` directory to empower your agent\n3. Modifying `docker-compose.yml` for advanced settings (optional)\n\nThe only requirement is Docker (or Podman, both are supported)! We provide detailed installation instructions for both Linux and Windows in the [Installation](#installation) section.\nAlso check the [notes](#some-notes) section for further information.\n\n---\n\n## What if I want to use Podman instead of Docker?\n\nPodman is a safer container environment than Docker. If you prefer Podman or use Fedora or any other RPM-based Linux distribution, you can use it instead of Docker:\n```bash\ngit clone https://github.com/winternewt/just-chat.git\npodman compose up \n```\nUnlike Docker, Podman is rootless-by-design and maps user and group id automatically. \n\n⚠️ **NOTE**: Ubuntu versions have different Podman availability:\n\n- **Ubuntu 24.04+**: Podman v4.9.3+ available via apt (recommended)\n- **Ubuntu 22.04**: Contains old Podman v.3 in apt, requires manual installation\n- Our installation script handles this automatically for Ubuntu 22.04\n\nThe only requirement is Docker (or Podman, both are supported)! We provide detailed installation instructions for both Linux and Windows in the [Installation](#installation) section.\nAlso check the [notes](#some-notes) section for further information.\n\n---\n\n## Installation\n\nJust-Chat is a containerized application. To run it you can use either Docker or Podman.\nYou can skip this section if you already have any of them installed. If you do not have a preference we recommend Podman as more modern and secure container engine.\n\nDetailed docker instructions:\n<details>\n<summary>Docker Installation on Linux</summary>\n\n---\n\n### Install Docker and Docker-compose Standalone\n\nRefer to the official guides: \n - [Docker Installation Guide](https://docs.docker.com/engine/install/ubuntu/).\n - [Docker Compose Standalone Installation Guide](https://docs.docker.com/compose/install/standalone/).\n \nFor Ubuntu 22.04+ users, you can use our automated installation script:\n```bash\nsudo ./scripts/install_docker_ubuntu.sh\n```\nThis script automatically handles Docker installation and Podman v4+ (builds from source on 22.04, installs from apt on 24.04+).\n\nOr follow these manual steps:\n\n#### Setup Docker's apt repository\n```bash\n\n---\n\n# Add Docker's official GPG key:\nsudo apt-get update\nsudo apt-get install ca-certificates curl\nsudo install -m 0755 -d /etc/apt/keyrings\nsudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc\nsudo chmod a+r /etc/apt/keyrings/docker.asc\n\n---\n\n### Installation Steps\n1. Download [Docker Desktop](https://docs.docker.com/desktop/setup/install/windows-install/)\n2. Run the installer and follow the prompts\n3. Restart your PC\n4. Launch Docker Desktop\n5. Docker Compose is included with Docker Desktop\n\nFor detailed instructions and troubleshooting, see the [official Windows installation guide](https://docs.docker.com/desktop/inst","github_created_at":"2025-01-29T14:28:08+00:00","created_at":"2026-07-11T10:41:53.384451+00:00","updated_at":"2026-08-08T00:01:02.335377+00:00","categories":[{"slug":"ai-agents","name":"AI Agents","url":"https://www.graphcanon.com/categories/ai-agents","markdown_url":"https://www.graphcanon.com/categories/ai-agents.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/ai-agents"},{"slug":"developer-tools","name":"Developer Tools","url":"https://www.graphcanon.com/categories/developer-tools","markdown_url":"https://www.graphcanon.com/categories/developer-tools.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/developer-tools"}],"tags":[{"slug":"chatbot","name":"chatbot"},{"slug":"docker-composition","name":"docker composition"},{"slug":"llm-agent","name":"llm-agent"},{"slug":"podman-support","name":"podman support"}],"trust":{"provenance":{"is_fork":false,"github_id":924163306,"owner_type":"Organization","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-08-08T00:01:01.354Z","maintenance":{"label":"Slowing","score":36,"methodology":"github_public_v1","releases_90d":0,"days_since_push":258,"last_release_at":null},"security_summary":{"status":"no_lockfile","scanner":null,"low_count":0,"high_count":0,"last_scan_at":"2026-07-11T10:41:54.804Z","medium_count":0,"scan_profile":"none","critical_count":0}},"capability_facts":{"scan":{"source":"repo_scan","observed_at":"2026-08-08T00:01:01.986Z"},"deploy":{"source":"dockerfile:docker-compose.yml","self_host":true,"observed_at":"2026-08-08T00:01:01.986Z","managed_saas":false},"languages":{"value":["python"],"source":"github.language","observed_at":"2026-08-08T00:01:01.986Z"},"has_docker":{"value":true,"source":"dockerfile:docker-compose.yml","observed_at":"2026-08-08T00:01:01.986Z"},"license_spdx":{"value":"Apache-2.0","source":"github.license","observed_at":"2026-08-08T00:01:01.986Z"}},"decision_facts":{"hosting":null,"pricing":null,"requirements":null,"constraints":null,"when_to_use":["When you need to quickly set up and interact with an LLM-based AI agent without extensive configuration.","For users on RPM-based distributions like Fedora, where Podman is the default container engine and considered safer."],"when_not_to_use":["If your workflow does not support Docker or Podman, as these are the only supported deployment environments.","When you are using Ubuntu 22.04 with the default Podman version (v3), which requires manual installation since it is not fully compatible with just-chat's setup."],"source":"enrich:decision_facts","observed_at":"2026-07-12T10:35:52.808Z"},"constraint_facets":null,"decision_summary":[{"label":"Adopt for","value":"just-chat is a Python framework for setting up an LLM-based AI agent using Docker or Podman for quick chat interactions. It supports customization and provides detailed installation instructions."}]}}