https://github.com/ericwarriner/oracle23aivectorsearch
A prototype web application using Oracle 23ai Vector Search Technology to match facial images.
https://github.com/ericwarriner/oracle23aivectorsearch
deno denofresh fresh oracle-23ai vector-database
Last synced: about 1 year ago
JSON representation
A prototype web application using Oracle 23ai Vector Search Technology to match facial images.
- Host: GitHub
- URL: https://github.com/ericwarriner/oracle23aivectorsearch
- Owner: ericwarriner
- License: mit
- Created: 2025-03-19T19:41:41.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-29T13:02:56.000Z (about 1 year ago)
- Last Synced: 2025-03-29T13:22:01.694Z (about 1 year ago)
- Topics: deno, denofresh, fresh, oracle-23ai, vector-database
- Language: TypeScript
- Homepage: https://23ai.org
- Size: 283 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## 🖼️ Application Preview
Below is a preview of the application user interface.

---
## 🚀 Live Demo
Check it out here: [Oracle 23ai Vector Search](https://23ai.org).
---
## 📦 Prerequisites
- [Deno](https://deno.land/manual/getting_started/installation)
- Docker (optional, for containerization)
- Oracle OCI or Google Cloud SDK (optional, for pushing Docker images)
- Oracle 23ai instance
---
## ⚙️ Environment Variables
This project relies on a VectorSearchMiddleware service and a Oracle Autonomous 23ai Database service that performs vector-based operations. Before running the app, please note that environment variables such as this API_URL will need to be set:
```bash
API_URL=http://:/encode_face
```
For example:
```bash
API_URL=http://129.80.96.10:8080/encode_face
```
You can export this in your terminal session or place it in a local `.env` file.
---
## 🐳 Docker Support
### Build the Docker Image
```bash
docker build -t -docker.pkg.dev///:latest .
```
For example:
```bash
docker build -t us-region-docker.pkg.dev/project-id/deno-app/deno-app:latest .
```
### Push to Google Artifact Registry
Authenticate with Google Cloud:
```bash
gcloud auth configure-docker -docker.pkg.dev
```
Push your Docker image:
```bash
docker push -docker.pkg.dev///:latest
```
---
## 📂 Project Structure
```
.
├── VectorSearchDatabase PopulationTool # Tool to populate Oracle 23ai database with images.
├── VectorSearchMiddleware # Middleware proxy to connect and interact with Oracle 23ai DB
├── VectorSearchUserInterface # Default UI and Application entry point
```
---
## ⚖️ Legal Disclaimer
This application demonstrates **Vector Search** powered by an [**Oracle 23ai Converged Database**](https://www.oracle.com/database/23ai/).
Oracle, the Oracle logo, and Oracle 23ai are trademarks or registered trademarks of Oracle and/or its affiliates.
This project is an independent application that utilizes Oracle technology. It is **not affiliated with**, **endorsed by**, or **sponsored by Oracle Corporation**.
Any Oracle trademarks used in this project are solely for the purpose of identifying the underlying technology and are the property of Oracle.
If you are an Oracle representative and have concerns about this usage, please contact me to resolve the matter.
---
## 🙌 Contributing
Contributions are welcome!
If you'd like to contribute, please fork the repo and submit a pull request. For major changes, open an issue first to discuss your ideas.
---
## 📄 License
This project is licensed under the [MIT License](LICENSE).
---