🧾 FiscAssistant

Your AI-powered tax assistant for Tunisia

Multilingual • Local • Private • Fast

FiscAssistant helps you calculate taxes, fill out declarations, set reminders, and learn about fiscal rules in Tunisia.
Supports French, English, Arabic, and Tunisian dialect.

---

🚀 Main Features

• Tax Calculations: VAT, IRPP, CNSS, CIT, property, vehicle, and more.
• Declarations: Deadlines, forms, late checks, and reminders.
• Regimes: Real, forfaitaire, simplified, patent, and sector-specific rules.
• Penalties & Risks: Late fees, sanctions, control simulation, and regularization.
• Profit Simulation: Net profit, break-even, project viability.
• Company Creation: Legal status, steps, obligations.
• Reminders & Notifications: Custom alerts for deadlines and law changes.
• Education: Simple explanations, definitions, quizzes, and links.
• Multilingual: French, English, Arabic, Tunisian dialect; switchable on demand.

---

🧠 Technologies

Component	Description
LLM	Nous-Hermes-2 via Ollama
Backend	FastAPI (Python) for API, logic, and RAG
Frontend	Next.js/React (custom UI, based on Chatbot Ollama)
Vector DB	ChromaDB for semantic search and retrieval
Embeddings	HuggingFace MiniLM (multilingual)
Custom Logic	Fiscal calculations (VAT, IRPP, CNSS, etc.) in Python

---

🖥️ Local Deployment

1. Clone the project

git clone https://github.com/votre-utilisateur/fiscassistant.git
cd fiscassistant

2. Backend Setup

• Install Python dependencies:

  pip install -r requirements.txt

• Download and run the LLM model with Ollama:

  ollama pull nous-hermes2:10.7b-solar-q3_K_M
  ollama serve
  ollama run nous-hermes2:10.7b-solar-q3_K_M

• Start FastAPI backend:

  uvicorn main:app --host 0.0.0.0 --port 8000 --reload

3. Frontend Setup

• Go to frontend folder:

  cd Frontend

• Install Node.js dependencies:

  npm ci

• Start frontend:

  npm run dev

• Visit http://localhost:3000 in your browser.

---

📜 License

Open-source for educational/personal use. For commercial use, check the LLM model license.