Skip to main content
Glama
README.md
# Tiny Chat

[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/to-aoki/tiny_chat)

## Installation

Tested with Python 3.10 or later

### Development Installation
```bash
pip install -r requirements.txt
```

### Package Installation
```bash
# Build the package
pip install build
python -m build

# Install the built package
pip install dist/*.whl
```

## Web Interface Usage

### Running from source (development)
```bash
streamlit run tiny_chat/main.py --server.address=127.0.0.1
```

### only database (development)
```bash
streamlit run tiny_chat/main.py --server.address=127.0.0.1 -- --database
```

### Running installed package
```bash
tiny-chat
```

### only database
```bash
tiny-chat --database
```

![img.png](img.png)

## MCP Usage
Claude Desktop example.
```json
{
  "mcpServers": {
    "tiny-chat": {
      "command": "/path/to/tiny_chat/.venv/bin/tiny-chat-mcp",
      "env": {
        "DB_CONFIG": "/path/to/tiny_chat/database_config.json"
      }
    }
  }
}
```

## OpenAI Chat API RAG Server Usage
```bash
tiny-chat-api
```
`model`: target search qdrant collection name (model change in conversation).
```bash
curl http://localhost:8080/v1/chat/completions   -H "Content-Type: application/json"   -d '{"model": "qdrant-collection-name", "messages": [{"role": "user", "content": "カレーライスの材料は?"}]}'
```

TDQS

D1.5/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of selecting between overlapping tools. The vague description does not create disambiguation issues.

Naming Consistency3/5

With a single tool, there is no pattern to evaluate for consistency. The name 'search-default' is unconventional but does not conflict with other naming styles.

Tool Count1/5

A single tool for a chat-focused server is clearly insufficient. The tool 'search-default' appears trivial and not aligned with the server's apparent domain.

Completeness1/5

The server provides no chat-related operations such as messaging or channel management. It appears severely incomplete for a chat server, offering only a vague search capability.

Maintenance

ActivityInactive
ResponsivenessNo issues