https://github.com/palmshed/llamavision
vision demo.
https://github.com/palmshed/llamavision
ai fastapi javascript react vision
Last synced: 18 days ago
JSON representation
vision demo.
- Host: GitHub
- URL: https://github.com/palmshed/llamavision
- Owner: palmshed
- License: mit
- Created: 2025-01-24T17:56:45.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-05-31T05:33:46.000Z (26 days ago)
- Last Synced: 2026-05-31T09:26:13.566Z (26 days ago)
- Topics: ai, fastapi, javascript, react, vision
- Language: JavaScript
- Homepage:
- Size: 388 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# llama/vision
[](https://github.com/bniladridas/llama-vision)
A containerized AI vision demo with a FastAPI backend and React frontend for image analysis.
## Features
* FastAPI backend for image analysis
* React frontend with upload interface
* Docker-based deployment
* Unit and E2E testing setup
## Structure
```
llama-vision/
├── backend/
│ ├── app.py
│ ├── Dockerfile
│ ├── requirements.txt
│ └── tests/
├── frontend/
│ ├── src/
│ ├── cypress/
│ └── package.json
├── scripts/
├── .github/workflows/
├── docker-compose.yml
└── README.md
```
## Setup
### Prerequisites
* Docker & Docker Compose
* Node.js 18+
* Python 3.9+
### Installation
```bash
git clone https://github.com/bniladridas/llama-vision.git
cd llama-vision
docker compose up --build
```
**Local Development**
```bash
# Backend
cd backend
pip install -r requirements.txt
python -m uvicorn app:app --reload
# Frontend
cd frontend
npm install
npm start
```
**Access**
* Frontend → [http://localhost:3000](http://localhost:3000)
* Backend API → [http://localhost:8001](http://localhost:8001)
## Testing
```bash
# Backend
cd backend && pytest
# Frontend
cd frontend && npm test
# E2E
cd frontend && npm run cypress:open
```
## Contributing
Follow [Conventional Commits](https://www.conventionalcommits.org/).
Example:
```bash
git commit -m "feat: add image analysis dashboard"
```
**Setup**
```bash
cp scripts/commit-msg .git/hooks/commit-msg
```
**Types**
`feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`, `perf`, `ci`, `build`, `revert`
## Docker
```bash
docker build -t llama-vision-backend ./backend
docker build -t llama-vision-frontend ./frontend
docker compose up
```