Dev

.dockerignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.py[cod]
+*$py.class
+.venv/
+.env
+local_qdrant/
+var/
+data/
+.git/
+.github/
+.pytest_cache/
+tests/

.env.example

@@ -1,10 +1,36 @@
-# mAIcro Configuration
-ORG_NAME="MicroClub-USTHB"
-ORG_DESCRIPTION="The first Algerian Scientific Club, founded in 1985."
+# ─────────────────────────────────────────────────
+# mAIcro — Environment Configuration
+# Copy this file to .env and fill in your values.
+# ─────────────────────────────────────────────────
 
-# AI Providers
-GEMINI_KEY="your-key-here"
-MODEL_NAME="xxx"
+# ── LLM Provider ────────────────────────────────
+LLM_PROVIDER=google
+GEMINI_API_KEY=         
 
-# Database
-DATABASE_URL="postgresql://user:pass@localhost:5432/maicro"
+
+# ── Discord ─────────────────────────────────────
+# Create a bot at https://discord.com/developers/applications
+# Enable MESSAGE CONTENT intent, then invite the bot to your server
+# with "Read Message History" + "View Channels" permissions.
+
+# Discord Bot Token (Bot -> Token -> Copy)
+DISCORD_BOT_TOKEN=
+
+# Comma-separated channel IDs to ingest, e.g. 123456789,987654321
+DISCORD_CHANNEL_IDS=
+
+# ── Qdrant (Vector Database) ────────────────────
+# Sign up for the free 1 GB tier at https://cloud.qdrant.io
+# Create a cluster -> copy the URL and API key below.
+
+# Qdrant URL (e.g. https://abc123-xyz.us-east4-0.gcp.cloud.qdrant.io:6333)
+QDRANT_URL=
+
+# Qdrant API Key (Cluster -> API Keys -> Create)
+QDRANT_API_KEY=
+
+# ── Organization (optional) ─────────────────────
+# Customize the AI personality for your org.
+# ORG_NAME=MyOrganization
+# ORG_DESCRIPTION=A brief description of your organization
+# COLLECTION_NAME=my_org_knowledge

.github/workflows/ci.yml

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - dev
+  pull_request:
+    branches:
+      - dev
+      - main
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Install dependencies
+        run: uv sync --dev
+
+      - name: Run tests
+        run: uv run pytest

.github/workflows/release.yml

@@ -0,0 +1,91 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository_owner }}/maicro
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+      attestations: write
+      id-token: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Docker metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=sha,prefix=sha-,format=short
+            type=ref,event=branch
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v4
+
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build and push
+        id: build
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          platforms: linux/amd64,linux/arm64
+          provenance: true
+          sbom: true
+
+      - name: Generate attestation
+        uses: actions/attest-build-provenance@v2
+        with:
+          subject-name: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}@${{ steps.build.outputs.digest }}
+          push-to-registry: true
+
+      - name: Make GHCR package public
+        if: always()
+        env:
+          GITHUB_API_URL: https://api.github.com
+          OWNER: ${{ github.repository_owner }}
+          PACKAGE: maicro
+          TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          set -euo pipefail
+          echo "Checking owner type for $OWNER"
+          owner_type=$(curl -sS -H "Authorization: Bearer $TOKEN" "$GITHUB_API_URL/users/$OWNER" | python -c "import sys, json; print(json.load(sys.stdin).get('type',''))")
+          echo "Owner type: $owner_type"
+          if [ "$owner_type" = "Organization" ]; then
+            url="$GITHUB_API_URL/orgs/$OWNER/packages/container/$PACKAGE/visibility"
+          else
+            url="$GITHUB_API_URL/user/packages/container/$PACKAGE/visibility"
+          fi
+          echo "Making package public via $url"
+          resp=$(curl -sS -o /dev/stderr -w "%{http_code}" -X PUT -H "Accept: application/vnd.github+json" -H "Authorization: Bearer $TOKEN" "$url" -d '{"visibility":"public"}')
+          if [ "$resp" -ge 200 ] && [ "$resp" -lt 300 ]; then
+            echo "Package visibility set to public"
+          else
+            echo "Failed to set package visibility (status $resp). You may need to make the package public manually in the GitHub UI or grant the workflow token additional permissions." >&2
+            exit 0
+          fi

.gitignore

@@ -19,6 +19,7 @@ lib64/
 parts/
 sdist/
 var/
+local_qdrant/
 wheels/
 share/python-wheels/
 *.egg-info/
@@ -205,3 +206,6 @@ cython_debug/
 marimo/_static/
 marimo/_lsp/
 __marimo__/
+
+# Qdrant
+qdrant_storage/

.python-version

@@ -0,0 +1 @@
+3.13

CONTRIBUTING.md

@@ -0,0 +1,49 @@
+# Contributing
+
+Thanks for your interest in contributing to **mAIcro**.
+
+## Ways to help
+
+- Report bugs (include steps to reproduce and expected vs actual behavior).
+- Suggest features (include the problem you’re trying to solve and constraints).
+- Improve docs (typos, examples, setup clarity).
+- Send PRs (small, focused changes are easiest to review).
+
+If you’ve found a security issue, please follow `SECURITY.md` instead of opening a public issue.
+
+Start the local dev service:
+
+```bash
+uv sync --dev
+cp .env.example .env
+# Edit .env and set at least:
+# LLM_PROVIDER=google
+# GEMINI_API_KEY=...
+# QDRANT_URL=http://localhost:6333
+```
+
+## Common commands
+
+Run tests:
+
+```bash
+uv run pytest
+```
+
+Start the API locally:
+
+```bash
+uv run uvicorn main:app --reload --host 0.0.0.0 --port 8000
+```
+
+## Pull requests
+
+- Keep PRs focused and small when possible.
+- Include tests for behavior changes and bug fixes.
+- Update `README.md` / docs for user-facing changes.
+- Don’t commit secrets (keep `.env` local; update `.env.example` if you add a new setting).
+- Don’t commit local state directories (for example `var/` or `local_qdrant/`).
+
+## Reporting issues
+
+Use GitHub Issues for bugs and feature requests.

Dockerfile

@@ -0,0 +1,33 @@
+FROM python:3.12-slim AS builder
+
+RUN pip install uv
+
+ENV UV_COMPILE_BYTECODE=1
+ENV UV_LINK_MODE=copy
+
+WORKDIR /app
+
+COPY pyproject.toml uv.lock README.md ./
+
+RUN --mount=type=cache,target=/root/.cache/uv \
+  uv sync --frozen --no-install-project --no-dev
+
+COPY src ./src
+
+RUN --mount=type=cache,target=/root/.cache/uv \
+  uv sync --frozen
+
+FROM python:3.12-slim
+
+WORKDIR /app
+
+COPY --from=builder /app/.venv /app/.venv
+
+ENV PATH="/app/.venv/bin:$PATH"
+ENV PYTHONPATH="/app/src"
+
+COPY src ./src
+
+EXPOSE 8000
+
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Micro Club
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.