Text Analysis

🔍 An advanced text analytics tool with intuitive visualization capabilities.

🎬 Demo Video (Coming Soon!)

📋 Overview

Note

No Python or technical knowledge required! This tool is designed for everyone, regardless of programming experience.

Text Analysis provides researchers and analysts with powerful natural language processing capabilities, helping you uncover patterns and insights in text data. Particularly effective for analyzing:

• Survey responses
• Interview transcripts
• Student feedback

✨ Features

• Topic Modeling: Discover hidden themes in your text corpus using advanced algorithms
• Word Cloud Visualization: Generate interactive visualizations of term frequency
• Sentiment Analysis: Quantify emotional tone and polarity in text data
• User-friendly Interface: Streamlit-based UI requiring no coding knowledge
• uv Powered Setup: One-click installation that installs Python and all dependencies in seconds - no technical knowledge needed!

🔧 First Time Setup

Warning

Do not skip these steps if this is your first time using this application. It will not work without them.

Tip

Save the repository in a Projects/CEDA folder on your main drive for quick access.

1. Get the Repository

Option A: Clone with Git (or Github Desktop)

git clone https://github.com/cedanl/textanalysis.git
cd textanalysis

Option B: Download ZIP

After downloading extract the ZIP file and navigate into the folder.

2. Install

MacOS & Linux (Terminal)

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (Powershell or Windows Terminal)

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Close and reopen your terminal after installation.

Verify installation

uv self update

See the installation documentation for details and alternative installation methods.

🚀 Running the Application

Ready to see the magic happen? Your text analysis app is just one command away! ✨

First, get to the right spot:

Open a terminal in your textanalysis folder - it's super easy!

• Windows: Shift + Right-click in folder → Open in Windows Terminal
• Mac: Right-click folder → New Terminal at Folder
• VS Code: Just click Terminal → New Terminal

Or simply navigate there:

cd path/to/textanalysis

Then, launch with a single command:

uv run streamlit run src/main.py

That's it! The app will automatically spring to life in your browser. If you've completed all the steps in the First Time Setup correctly, this is the only command you'll need going forward. 🎉

Pro Tip: Create a shortcut: .bat file (Windows) or .sh script (macOS/Linux)

Happy analyzing! ✨📊📝

🛠️ Built With

🤲 Support

If you find this project helpful, please consider:

• ⭐ Starring the repo
• 🐛 Reporting bugs
• 💡 Suggesting features
• 💻 Contributing code

If you encounter any issues or need further assistance, please feel free to open an issue or contact amir.khodaie@ru.nl

🙏 Acknowledgements

Special thanks to:

• Amir Khodaie for starting the project and laying the foundation.
• Ash Sewnandan & Tomer Iwan for elevating the project to professional standards by creating a complete, user-friendly application with a polished interface and robust architecture.
• CEDA & Npuls for making this project possible by providing valuable resources and support.

🫂 Contributors

Thank you to all the people who have already contributed to textanalysis.

🚦 License