Neura Market
Just-Chat logo

Just-Chat

Free

Make your LLM agent and chat with it simple and fast!

FreeFree tier
Type
Open Source
Visit Website GitHub (38 stars)

About Just-Chat

Just-Chat is an open-source tool that lets you create and interact with a local LLM agent with minimal setup. By simply cloning the repository and running docker-compose up, you get a fully containerized chat interface accessible at localhost:3000. The agent is highly customizable: you can define its behavior via a YAML profile and extend its capabilities by adding Python tools. It leverages the just-agents library to support a wide range of modern models (e.g., DeepSeek Reasoner, ChatGPT, LLAMA3.3) and includes a default (rate-limited) free Groq API key. The entire system runs in Docker (or Podman) and does not require Python or Node.js on the host machine, making it easy to deploy on any system with container support.

Key Features

One-command Docker setup (docker-compose up) to start chatting
Customizable AI assistant defined in a YAML configuration file
Extensible with custom Python tools in the /agent_tools directory
Web chat interface at localhost:3000
Runs entirely in containers; no Python or Node.js required on the host
Supports modern LLMs (DeepSeek Reasoner, ChatGPT, LLAMA3.3, etc.) via just-agents library
Comes with a default free Groq API key (rate-limited)

Pros & Cons

Pros
  • Extremely quick to get started – just clone and run docker-compose up
  • Open source and free to use with no licensing restrictions
  • Highly customizable via YAML profiles and Python tool addition
  • Containerized deployment ensures portability and clean isolation
  • Supports many modern LLMs through the just-agents library
  • Works without requiring Python or Node.js on the host system
Cons
  • Default Groq API key is heavily rate-limited, may require obtaining personal API keys for serious use
  • Requires Docker or Podman; not suitable for environments without container support
  • Not intended for production-scale deployments; assumes local or development use
  • Some models (e.g., ChatGPT) require separate API keys not bundled with the tool

Best For

Rapidly prototyping a local LLM-powered chat agentCustomizing agent behavior and tools for specific tasksRunning an LLM agent without installing Python or Node.js locallyExperimenting with different models (OpenAI, DeepSeek, Llama, etc.) in a containerized environment

FAQ

What are the system requirements to run Just-Chat?
You need Docker or Podman installed. Docker is recommended for most users; Podman users on Linux may need Podman v4.9.3 or higher, especially on Ubuntu.
How do I customize my AI agent?
Edit the chat_agent_profiles.yaml file to change the agent's configuration. You can also add custom Python tools by placing them in the /agent_tools directory.
Which language models can I use with Just-Chat?
Just-Chat uses the just-agents library, which supports most modern models including DeepSeek Reasoner, ChatGPT, and LLAMA3.3. You need to provide your own API keys for these models.
Is there a free API key included?
Yes, a default free Groq API key is provided, but it is rate-limited. For better performance, it is recommended to obtain your own API key (e.g., from Groq or other providers).
Can I use Podman instead of Docker?
Yes, Podman is supported. Use 'podman compose up' instead of 'docker-compose up'. Note that Podman v4.9.3 or higher is required on Ubuntu.