Skip to content

StandardCAS/Arcana

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MIT License ArcanaLTE Version Development Status Built with Streamlit Powered by StandardCAS


🌌 Welcome to Arcana Extreme

✨ By the Indexademics Team | Powered by StandardCAS™ [Version 1.0 Beta 03 (2025-07-04)]


📚 Table of Contents

  1. Introduction
  2. Versions
  3. Make It Yours – Private & Custom Chatbots
  4. How to Use
  5. Works Cited
  6. License

💖 Introduction

Welcome to Arcana Extreme — your intelligent, dynamic study resource hub! Built to empower students with fast and accurate support, Arcana is designed to help you succeed in your learning journey through smart question answering, document indexing, and rich content generation.

Whether you're studying for exams or building resources, Arcana is your trusty academic sidekick.

For users in the CLASS OF '27: The responses you receive will likely be from Peer Advisor materials. Here is a disclaimer that review guides, practice sets, and practice tests are UNOFFICIAL sources of reference and do NOT include or hint at questions in the actual exams!


🔮 Available Versions

You are currently using ArcanaLTE (Long Term Evolution), the lightweight yet powerful version of the Indexademics platform.

ArcanaLTE Æ151 
✔ Full Indexademics chatbot functionality
✔ Document-based database searching
✔ ArcanaMixup for PPT and Doc generation

ArcanaExtreme ß103 (Current)
➕ Contour Design
➕ All features of ArcanaLTE
➕ Peer Advisor Journalism suite
➕ StandardCAS™ report generator
➕ Transcription, TTS audio, image generation, visual interpreters

ArcanaDesktop θ101 (macOS Only) 
➕ Homework auto analysis
➕ Task manager with auto-resolved calendar
➕ Web analytics, AGI admin workflows


ArcanaDB
📁 Database creation suite for independent AI chatbots
📁 Ideal for flexible custom data integration

🛡 Make It Private and Customized!

Want to keep your chatbot private and unique to your needs? We've got you covered. Arcana is built with Streamlit, which makes it easy to:

  • Fork this repository 💻
  • Deploy your own private chatbot server 🔐
  • Customize settings, style, and plugins to your personal preferences 🎨

📘 How to Use

New here? Don't worry, angel! Here's a quick rundown of the key concepts and how you can start using Arcana today.

🔍 Key Terms

  • Indexing: Converts files (PPTs, PDFs, DOCXs, CSVs, etc.) into structured, searchable data.
  • IDXDB: The "Database" — a temporary, session-based data cache used during chatbot interactions.

🧭 Navigation and Interface

🌟 Chatbot Page:
 - "Default" Mode → Uses ArcanaLTE's general AI bot
 - "IDX" Mode → Searches your own database content (from uploaded files)
 - "Reasoning" Mode → Uses the Qwen-QWQ model for in-depth, logical responses
 - "Long Text" Mode → Combines indexing and the Qwen-Long Text model for longer, more contextual answers

📂 Files Page:
 - Drag and drop your files to upload them
 - Wait for pre-indexing to finish
 - Files will appear in the "Finder" section
 - Organize your data and click "Index to Database" to finalize it
 - Once indexing is complete, switch to "IDX" mode in Chatbot to begin querying your data!

📚 Works Cited and Credits

For this Chatbot: 
Arcana Chatbot, Indexademics. March 31st, 2025. Powered by StandardCAS™.
FiberDB, StandardCAS™. Chengjui Osmond Fan, Juilyn Celsia. April 3, 2025.

For the Development Team:
Osmond G11 - Base algorithm coding, DBMS designing, API functions, and Accessories.
Celsia G11 - UI Coding and Swap Platform conditioning.
Brian G10 - Debugging and mirroring platform. 
Pete G10 - Database arrangement and testing.

For the Utilized Technologies:
Qwen, Alibaba Cloud Group.
Streamlit 1.22, Streamlit.io.



📜 License

This project is licensed under CC-BY-ND-SA by Indexademics.

This means:
❌ No derivatives
❌ No unauthorized redistribution
✅ Attribution required
✅ Sharing with proper credit allowed

StandardCAS™ contributed to major portions of code and infrastructure. They hold a lifelong, irrevocable license to distribute and modify the Arcana platform, under synchronization with Indexademics.

The Arcanalte model is based on Qwen (Alibaba Cloud), and fine-tuned by Indexademics.

Copyright © Indexademics 2023–
Copyright © StandardCAS™ 2019–

⚠️ The ArcanaLTE version is fully sponsored by Indexademics.

🔮 Arcana Extreme

The Ultimate AI-Powered Knowledge Assistant

Arcana Extreme is a sophisticated Streamlit application that transforms your documents into an intelligent, searchable knowledge base. With cutting-edge AI integration and beautiful visual interfaces, Arcana brings the power of artificial intelligence directly to your fingertips.

✨ Features

🧠 Smart Document Processing

  • Multi-format Support: PDF, DOCX, PPTX, TXT, CSV files
  • Intelligent Indexing: Advanced NLP-powered document analysis
  • Contextual Search: Find exactly what you need with semantic understanding

💬 AI-Powered Chat Interface

  • Context-Aware Responses: Chat with your documents using OpenAI GPT
  • Document Integration: Automatic context injection from your knowledge base
  • Smart Conversations: Maintains conversation history and context

🎨 Visual Presentation Tools

  • AI Presentation Generator: Create stunning PowerPoint presentations automatically
  • Smart Content Creation: Generate outlines, slides, and formatted content
  • Visual Slide Editor: PowerPoint/Keynote-style editor with streamlit-theta
  • Document Export: Export to both PowerPoint and Word formats

📚 Study Guide Generator (NEW!)

  • Multiple Study Styles: Comprehensive, summary, outline, flashcard-prep, and exam-focused modes
  • Intelligent Outline Generation: AI creates structured study guide outlines from your documents
  • Section-by-Section Content: Detailed explanations, examples, and practice questions
  • Formatted Export: Professional Word documents with table of contents and formatting
  • Cross-Platform Integration: Seamlessly switch between study guides and presentations

🃏 Q&A Flashcard Generator (NEW!)

  • Quick Flashcard Creation: Generate study flashcards from any topic
  • Interactive Review: Expandable question/answer format for effective studying
  • Bulk Generation: Create 5-20 flashcards at once
  • Export Options: Download as text files for external flashcard apps

🎯 Advanced Analytics

  • Long-form Analysis: Deep document analysis with Qwen models
  • Multiple Analysis Modes: Summary, takeaways, pros/cons, simplified explanations
  • Rich Text Editing: AI-powered document editor with diff visualization

🎙️ Speech Integration

  • Speech-to-Text: Convert voice recordings to text using DashScope
  • Real-time Transcription: Live voice input processing
  • Audio File Support: Process uploaded audio files

🎨 Beautiful Interface

  • Modern UI: Clean, intuitive design with dark/light themes
  • Responsive Layout: Works seamlessly across different screen sizes
  • Icon-based Navigation: Easy-to-use app-style interface

🚀 NEW: Streamlit Theta v1.0.0

We've built our own PowerPoint/Keynote-style visual editor for Streamlit!

Features:

  • 🎨 Drag-and-drop text boxes, images, and shapes
  • 📝 Real-time text editing with formatting controls
  • 🖼️ Visual slide thumbnails and navigation
  • 🎯 Property panels for precise styling
  • 💾 Save and export functionality
from streamlit_theta import theta_slide_editor

# Create a visual slide editor
slides = theta_slide_editor(
    slides=[...],  # Your slide data
    width=800,
    height=600,
    key="my_editor"
)

🛠️ Installation

Prerequisites

  • Python 3.7+
  • OpenAI API key
  • DashScope API key (optional, for image generation and speech features)

Quick Start

  1. Clone the repository

    git clone https://github.com/arcana/arcana-extreme.git
    cd arcana-extreme
  2. Install dependencies

    pip install -r requirements.txt
    pip install streamlit-theta  # Our custom visual editor
  3. Set up environment variables Create a .env file:

    OPENAI_API_KEY=your_openai_api_key_here
    DASHSCOPE_API_KEY=your_dashscope_api_key_here
    
  4. Run the application

    streamlit run ArcanaExtreme.py

📚 Usage

Document Management

  1. Upload Documents: Use the Files page to upload and index your documents
  2. Smart Indexing: Arcana automatically processes and indexes your content
  3. Search & Discovery: Use the chat interface to ask questions about your documents

AI Chat

  1. Start Conversations: Ask questions in natural language
  2. Context Integration: Arcana automatically includes relevant document context
  3. Rich Responses: Get detailed, contextual answers with sources

Presentation Creation

  1. Choose Topic: Enter your presentation topic
  2. AI Generation: Let AI create an outline and content
  3. Visual Editing: Use our Theta editor to customize slides visually
  4. Export: Download as PowerPoint or Word document

Study Guide Creation (NEW!)

  1. Select Topic & Style: Choose your study topic and preferred style (comprehensive, summary, outline, flashcard-prep, or exam-focused)
  2. Review Outline: AI generates a structured outline that you can edit
  3. Content Generation: AI creates detailed content for each section based on your documents
  4. Edit & Customize: Review and modify content in tabbed interface
  5. Export Options: Download as formatted Word document or plain text

Flashcard Generation (NEW!)

  1. Enter Topic: Specify what you want to create flashcards about
  2. Set Quantity: Choose 5-20 flashcards
  3. AI Generation: AI creates question-answer pairs
  4. Interactive Review: Study with expandable Q&A format
  5. Export: Download as text file for use in flashcard apps

🏗️ Architecture

Arcana Extreme is built with:

  • Frontend: Streamlit with custom components
  • AI Engine: OpenAI GPT models with DashScope integration
  • Document Processing: Advanced NLP with NLTK and custom parsers
  • Search Engine: FiberDBMS for fast, contextual document retrieval
  • Visual Editor: Custom streamlit-theta component

📝 API Reference

Core Components

FiberDBMS

from fiber import FiberDBMS

dbms = FiberDBMS()
dbms.add_document("doc.pdf", content, keywords)
results = dbms.query("search terms", top_n=5)

Presentation Generator

from mixup import create_presentation_from_content

ppt_path = create_presentation_from_content(
    presentation_content, 
    topic, 
    api_key
)

Theta Visual Editor

from streamlit_theta import theta_slide_editor

slides = theta_slide_editor(
    slides=slide_data,
    width=800,
    height=600,
    key="editor"
)

🤝 Contributing

We welcome contributions! Please read our contributing guidelines and submit pull requests to our GitHub repository.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • OpenAI for providing powerful language models
  • Alibaba Cloud for DashScope services
  • Streamlit team for the amazing framework
  • The open-source community for various tools and libraries

Made with ❤️ by the Arcana Team

Transform your documents into intelligent conversations with Arcana Extreme!

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%