Is file-brain still maintained?

Slowing down. Last change 7 months ago. Latest release v0.1.28, 7 months ago.

Can I trust file-brain?

Some track record. 237 stars, 12 months old. Get it from the official repo and read what it installs.

gitmanual

Reading the repo

Opening the box…

How to install on macOS

Hamza5/file-brain

Smart local file search app that understands your files

Node.js#apache-tika#archive-search#artificial-intelligence#desktop-application

Difficulty: Moderate
Time: about 15 min
Stars: ★ 237
Activity: Updated 7 months ago

Before you start

Is it free?: YesOpen source (GPL-3.0).
Still maintained?: Slowing downLast change 7 months ago. Latest release v0.1.28, 7 months ago.
Can I trust it?: Some track record237 stars, 12 months old. Get it from the official repo and read what it installs.

Saved setup from just now

Will it work on macOS?

Yes, with Docker on macOS

It's a self-hosted app: the README runs it with Docker, and you open it in your browser.
On macOS that means installing Docker Desktop first.

Your system

macOS Windows Linux

Start here

Website ↗file-brain.comThe project's own site.

Run it with Docker

A self-hosted app: Docker runs it on your computer and you open it in the browser. Needs Docker Desktop (or Docker Engine on Linux). Run docker compose commands inside the cloned repo folder.

Docker

docker pull hamza5/tika:latest-full

Docker

docker pull hamza5/typesense-gpu:29.0-cuda11.8.0-cudnn8-runtime-ubuntu22.04

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Node.js 24runtime
1×npm package manager

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/Hamza5/file-brain/badge.svg)](https://gitmanual.com/Hamza5/file-brain)

Good to know

Monorepo (workspaces) — install from the repo root.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: apps/file-brain/frontend/package.json, apps/file-brain/pyproject.toml, apps/website/package.json, packages/shared/package.json

Details

License: GPL-3.0
Open issues: 9
Branch: main

package.json scripts (25)

dev:websitenpm run dev --workspace=@file-brain/website
build:websitenpm run build --workspace=@file-brain/website
start:websitenpm run start --workspace=@file-brain/website
install:websitenpm install --workspace=@file-brain/website
dev:appcd apps/file-brain && poetry run python -m file_brain.main --mode dev
start:appcd apps/file-brain && poetry run python -m file_brain.main --mode prod
install:appnpm install --workspace=@file-brain/app && cd apps/file-brain && poetry install
package:appnpm run build:app-frontend && rm -rf apps/file-brain/file_brain/frontend/dist && cp -r apps/file-brain/frontend/dist apps/file-brain/file_brain/frontend/ && cd apps/file-brain && poetry build
build:app-frontendnpm run build --workspace=@file-brain/app
docker:upcd apps/file-brain/file_brain && TYPESENSE_DATA_DIR=$HOME/.local/share/file-brain/typesense-data docker compose up -d
docker:downcd apps/file-brain/file_brain && TYPESENSE_DATA_DIR=$HOME/.local/share/file-brain/typesense-data docker compose down
clean:containerscd apps/file-brain/file_brain && TYPESENSE_DATA_DIR=$HOME/.local/share/file-brain/typesense-data docker compose rm -sf && echo '✅ Containers removed (project only)'
clean:imagescd apps/file-brain/file_brain && TYPESENSE_DATA_DIR=$HOME/.local/share/file-brain/typesense-data docker compose down --rmi local && echo '✅ Images removed (project only)'
clean:images-fullcd apps/file-brain/file_brain && TYPESENSE_DATA_DIR=$HOME/.local/share/file-brain/typesense-data docker compose down --rmi local && docker image prune -af && echo '✅ Images and dependencies removed (shows realistic pull progress)'
clean:dockercd apps/file-brain/file_brain && TYPESENSE_DATA_DIR=$HOME/.local/share/file-brain/typesense-data docker compose down -v --rmi local && echo '✅ Docker cleaned: containers, volumes, and images removed (project only)'
clean:dbrm -f ~/.local/share/file-brain/file_brain.db && echo '✅ Database removed'
clean:typesensesudo rm -rf ~/.local/share/file-brain/typesense-data && echo '✅ Typesense data removed'
clean:allnpm run clean:docker && npm run clean:db && npm run clean:typesense && echo '✅ Full cleanup complete - ready for fresh wizard test'
clean:all-fullnpm run clean:images-full && npm run clean:db && npm run clean:typesense && echo '✅ Complete cleanup with dependencies - realistic wizard test'
db:revisioncd apps/file-brain && poetry run alembic revision --autogenerate -m
db:upgradecd apps/file-brain && poetry run alembic upgrade head
db:downgradecd apps/file-brain && poetry run alembic downgrade -1
db:historycd apps/file-brain && poetry run alembic history
db:currentcd apps/file-brain && poetry run alembic current
test:appcd apps/file-brain && poetry run pytest

Files we read (5)

.github/workflows/ci.yml

.github/workflows/deploy-website.yml

.github/workflows/release.yml

README.md

package.json

254 files in the repo