# weaviate-ui

**Repository Path**: haohaoding/weaviate-ui

## Basic Information

- **Project Name**: weaviate-ui
- **Description**: 在原开源地址：https://github.com/naaive/weaviate-ui，进行的二开
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: release
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-04
- **Last Updated**: 2026-03-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Weaviate-UI

![screenshot](screenshot.png)
![screenShot_document.png](screenShot_document.png)

Weaviate-UI is a web client for interacting with the Weaviate.

## Features

- Schema query
- Data search
- Advanced filtering with multiple conditions
- Support for nested properties (_metadata)
- Boolean, number, and text property search

## Usage

### Docker

```bash
$ docker run -e WEAVIATE_URL=http://localhost:8091 -e WEAVIATE_API_KEYS=secret naaive/weaviate-ui:latest
```

### Local Development

#### Prerequisites

- Python 3.11+
- Node.js 16+
- Poetry (for Python dependency management)

#### Setup

1. **Clone the repository**
   ```bash
   git clone <repository-url>
   cd weaviate-ui
   ```

2. **Configure environment variables**
   ```bash
   cp .env.example .env
   ```
   
   Edit `.env` file and configure your Weaviate connection:
   ```
   WEAVIATE_URL=http://localhost:8080
   WEAVIATE_API_KEYS=your_api_key_here
   ```

3. **Install Python dependencies**
   ```bash
   poetry install
   ```

4. **Build frontend**
   ```bash
   cd frontend
   npm install
   npm run build
   ```
   注意：需要将打包好到dist文件内容复制到backend/static目录下
5. **Start the application**
   ```bash
   # From project root directory
   poetry run python main.py
   ```
   
   Or with Python directly:
   ```bash
   python main.py
   ```

6. **Access the application**
   
   Open your browser and navigate to: http://localhost:7777

#### Development Mode (Frontend)

For frontend development with hot reload:

```bash
cd frontend
npm install
npm run dev
```

This will start the Vite dev server, typically on http://localhost:5173.

## Features in Detail

### Search and Filter

- **Property selection**: Choose from all available properties including id
- **Operator types**:
  - Equals / Not equals
  - Contains / Not contains
  - Greater than / Greater than or equal
  - Less than / Less than or equal
  - Like (case-insensitive fuzzy match)
- **Multiple conditions**: Add multiple filter conditions that are combined with AND logic
- **Type handling**: Automatic type conversion for boolean, numeric, and text values

## Contribution

Any form of contribution is welcome, including but not limited to submitting bug reports, proposing new features, improving code, etc.