Spaces:
Running
Running
Amlan-109 commited on
Commit ·
051d98e
1
Parent(s): 34fbbbf
chore: force LFS tracking for all binary assets
Browse files
DATA/Setup_Guide.html
DELETED
|
@@ -1,162 +0,0 @@
|
|
| 1 |
-
<!DOCTYPE html>
|
| 2 |
-
<html lang="en">
|
| 3 |
-
<head>
|
| 4 |
-
<meta charset="UTF-8">
|
| 5 |
-
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
| 6 |
-
<title>LocalAI (Amlan Edition) - Setup Guide</title>
|
| 7 |
-
<style>
|
| 8 |
-
body {
|
| 9 |
-
font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
|
| 10 |
-
line-height: 1.6;
|
| 11 |
-
color: #333;
|
| 12 |
-
max-width: 800px;
|
| 13 |
-
margin: 0 auto;
|
| 14 |
-
padding: 40px;
|
| 15 |
-
background-color: #f9f9f9;
|
| 16 |
-
}
|
| 17 |
-
.container {
|
| 18 |
-
background-color: white;
|
| 19 |
-
padding: 40px;
|
| 20 |
-
border-radius: 8px;
|
| 21 |
-
box-shadow: 0 4px 6px rgba(0,0,0,0.1);
|
| 22 |
-
}
|
| 23 |
-
h1 {
|
| 24 |
-
color: #2c3e50;
|
| 25 |
-
border-bottom: 2px solid #3498db;
|
| 26 |
-
padding-bottom: 10px;
|
| 27 |
-
margin-top: 0;
|
| 28 |
-
}
|
| 29 |
-
h2 {
|
| 30 |
-
color: #34495e;
|
| 31 |
-
margin-top: 30px;
|
| 32 |
-
border-left: 5px solid #3498db;
|
| 33 |
-
padding-left: 10px;
|
| 34 |
-
}
|
| 35 |
-
h3 {
|
| 36 |
-
color: #7f8c8d;
|
| 37 |
-
}
|
| 38 |
-
code {
|
| 39 |
-
background-color: #f1f2f6;
|
| 40 |
-
padding: 2px 5px;
|
| 41 |
-
border-radius: 4px;
|
| 42 |
-
font-family: 'Courier New', Courier, monospace;
|
| 43 |
-
color: #c0392b;
|
| 44 |
-
}
|
| 45 |
-
pre {
|
| 46 |
-
background-color: #2c3e50;
|
| 47 |
-
color: #ecf0f1;
|
| 48 |
-
padding: 15px;
|
| 49 |
-
border-radius: 5px;
|
| 50 |
-
overflow-x: auto;
|
| 51 |
-
font-family: 'Courier New', Courier, monospace;
|
| 52 |
-
}
|
| 53 |
-
.note {
|
| 54 |
-
background-color: #ffeaa7;
|
| 55 |
-
border-left: 5px solid #fdcb6e;
|
| 56 |
-
padding: 15px;
|
| 57 |
-
margin: 20px 0;
|
| 58 |
-
font-size: 0.9em;
|
| 59 |
-
}
|
| 60 |
-
.footer {
|
| 61 |
-
margin-top: 50px;
|
| 62 |
-
text-align: center;
|
| 63 |
-
font-size: 0.8em;
|
| 64 |
-
color: #bdc3c7;
|
| 65 |
-
}
|
| 66 |
-
ul {
|
| 67 |
-
list-style-type: circle;
|
| 68 |
-
}
|
| 69 |
-
@media print {
|
| 70 |
-
body {
|
| 71 |
-
background-color: white;
|
| 72 |
-
padding: 0;
|
| 73 |
-
}
|
| 74 |
-
.container {
|
| 75 |
-
box-shadow: none;
|
| 76 |
-
padding: 0;
|
| 77 |
-
}
|
| 78 |
-
a {
|
| 79 |
-
text-decoration: none;
|
| 80 |
-
color: black;
|
| 81 |
-
}
|
| 82 |
-
}
|
| 83 |
-
</style>
|
| 84 |
-
</head>
|
| 85 |
-
<body>
|
| 86 |
-
<div class="container">
|
| 87 |
-
<h1>LocalAI (Amlan Edition) - Setup Guide</h1>
|
| 88 |
-
<p><strong>Version:</strong> 1.0.0 (Custom Build)</p>
|
| 89 |
-
<p><strong>Author:</strong> Amlan Mallick</p>
|
| 90 |
-
<p><strong>Date:</strong> February 09, 2026</p>
|
| 91 |
-
|
| 92 |
-
<h2>1. Project Overview</h2>
|
| 93 |
-
<p>
|
| 94 |
-
LocalAI (Amlan Edition) is a customized version of the open-source LocalAI project, tailored specifically
|
| 95 |
-
by Amlan Mallick. It serves as a drop-in replacement for OpenAI's API, allowing you to run Large Language Models (LLMs),
|
| 96 |
-
generate images, and synthesize audio locally on your own hardware without needing a GPU.
|
| 97 |
-
</p>
|
| 98 |
-
<p>This customized version includes specialized branding, a dedicated Author portfolio page, and enhanced UI elements.</p>
|
| 99 |
-
|
| 100 |
-
<h2>2. Technologies Used</h2>
|
| 101 |
-
<ul>
|
| 102 |
-
<li><strong>Backend:</strong> Go (Golang) - High performance server handling API requests.</li>
|
| 103 |
-
<li><strong>Frontend:</strong> HTML Templates with Tailwind CSS & Alpine.js - Lightweight, responsive UI.</li>
|
| 104 |
-
<li><strong>Containerization:</strong> Docker - Provides a consistent environment across all operating systems.</li>
|
| 105 |
-
<li><strong>Inference Engine:</strong> C++/Python bindings (llama.cpp, etc.) for running AI models.</li>
|
| 106 |
-
</ul>
|
| 107 |
-
|
| 108 |
-
<h2>3. Prerequisites</h2>
|
| 109 |
-
<p>To run this project on any computer (Windows, Mac, or Linux), you need:</p>
|
| 110 |
-
<ul>
|
| 111 |
-
<li><strong>Docker Desktop:</strong> Essential for building and running the container. (Installation required)</li>
|
| 112 |
-
<li><strong>Git (Optional):</strong> For cloning the repository.</li>
|
| 113 |
-
<li><strong>16GB+ RAM (Recommended):</strong> Running AI models requires memory.</li>
|
| 114 |
-
</ul>
|
| 115 |
-
|
| 116 |
-
<h2>4. Installation Steps (Any Computer)</h2>
|
| 117 |
-
|
| 118 |
-
<h3>Step 1: Get the Code</h3>
|
| 119 |
-
<p>Download the project source code directly or clone it from the repository.</p>
|
| 120 |
-
<pre>git clone https://github.com/Amlan-109/LocalAI-master.git
|
| 121 |
-
cd LocalAI-master</pre>
|
| 122 |
-
|
| 123 |
-
<h3>Step 2: Build the Docker Image</h3>
|
| 124 |
-
<p>Use Docker to compile the application into a standalone image. This creates a portable package containing everything needed to run LocalAI.</p>
|
| 125 |
-
<pre>docker build -t localai-amlan .</pre>
|
| 126 |
-
<div class="note">
|
| 127 |
-
<strong>Note:</strong> This process may take 5-15 minutes depending on your internet speed, as it downloads dependencies and compiles the source code.
|
| 128 |
-
</div>
|
| 129 |
-
|
| 130 |
-
<h3>Step 3: Run the Application</h3>
|
| 131 |
-
<p>Start the container using the image you just built. We map port 8080 so you can access it in your browser.</p>
|
| 132 |
-
<pre>docker run -p 8080:8080 --name local-ai-amlan -ti localai-amlan</pre>
|
| 133 |
-
|
| 134 |
-
<h2>5. Accessing the Features</h2>
|
| 135 |
-
<p>Once the container is running, open your web browser:</p>
|
| 136 |
-
<ul>
|
| 137 |
-
<li><strong>Main Interface:</strong> <a href="http://localhost:8080">http://localhost:8080</a></li>
|
| 138 |
-
<li><strong>Author Portfolio:</strong> <a href="https://dev-portfolio-showcase-v1.web.app/" target="_blank">https://dev-portfolio-showcase-v1.web.app/</a></li>
|
| 139 |
-
<li><strong>API Endpoint:</strong> <a href="http://localhost:8080/v1/chat/completions">http://localhost:8080/v1/chat/completions</a></li>
|
| 140 |
-
</ul>
|
| 141 |
-
|
| 142 |
-
<h2>6. Troubleshooting</h2>
|
| 143 |
-
<ul>
|
| 144 |
-
<li><strong>Port Conflict:</strong> If port 8080 is already in use, change the command to use a different port (e.g., 9090):
|
| 145 |
-
<code>docker run -p 9090:8080 ...</code>
|
| 146 |
-
</li>
|
| 147 |
-
<li><strong>Models Not Found:</strong> You may need to mount a volume to store models persistently:
|
| 148 |
-
<code>-v ./models:/build/models</code>
|
| 149 |
-
</li>
|
| 150 |
-
</ul>
|
| 151 |
-
|
| 152 |
-
<div class="footer">
|
| 153 |
-
© 2023-2026 Amlan Mallick. All Rights Reserved.
|
| 154 |
-
</div>
|
| 155 |
-
</div>
|
| 156 |
-
|
| 157 |
-
<script>
|
| 158 |
-
// Optional: Auto-print dialog on load
|
| 159 |
-
// window.onload = function() { window.print(); }
|
| 160 |
-
</script>
|
| 161 |
-
</body>
|
| 162 |
-
</html>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
DATA/WhatsApp Image 2025-12-27 at 5.40.51 PM.jpeg
DELETED
Git LFS Details
|
DATA/full-stack-developer-and-ui-ux-designer-with-award-winning-projects (3) (1).pdf
DELETED
|
@@ -1,3 +0,0 @@
|
|
| 1 |
-
version https://git-lfs.github.com/spec/v1
|
| 2 |
-
oid sha256:bb6a1af08126c042ff5f449613695854c5145a5f4107b451077cbe82c4e94a93
|
| 3 |
-
size 1520630
|
|
|
|
|
|
|
|
|
|
|
|
Dockerfile
CHANGED
|
@@ -372,5 +372,6 @@ HEALTHCHECK --interval=1m --timeout=10m --retries=10 \
|
|
| 372 |
CMD curl -f ${HEALTHCHECK_ENDPOINT} || exit 1
|
| 373 |
|
| 374 |
VOLUME /models /backends /configuration
|
| 375 |
-
EXPOSE
|
|
|
|
| 376 |
ENTRYPOINT [ "/entrypoint.sh" ]
|
|
|
|
| 372 |
CMD curl -f ${HEALTHCHECK_ENDPOINT} || exit 1
|
| 373 |
|
| 374 |
VOLUME /models /backends /configuration
|
| 375 |
+
EXPOSE 7860
|
| 376 |
+
ENV PORT=7860
|
| 377 |
ENTRYPOINT [ "/entrypoint.sh" ]
|
entrypoint.sh
CHANGED
|
@@ -32,4 +32,9 @@ else
|
|
| 32 |
echo "CPU: no AVX512 found"
|
| 33 |
fi
|
| 34 |
|
| 35 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 32 |
echo "CPU: no AVX512 found"
|
| 33 |
fi
|
| 34 |
|
| 35 |
+
# Handle the PORT environment variable for platforms like Hugging Face
|
| 36 |
+
if [ -n "$PORT" ]; then
|
| 37 |
+
exec ./local-ai --address :$PORT "$@"
|
| 38 |
+
else
|
| 39 |
+
exec ./local-ai "$@"
|
| 40 |
+
fi
|