Digital Necromancer is a powerful full-stack web application that breathes new life into old, legacy codebases. Like a necromancer who revives the dead, this tool uses openai/gpt-oss-20b to analyze, explain, and modernize outdated code snippets and entire legacy projects.
Whether you're dealing with callback hell from the early 2010s, deprecated jQuery patterns, or ancient PHP code that makes you cry, Digital Necromancer transforms your legacy nightmares into modern, maintainable masterpieces.
Problem it solves:
- Legacy code migration and modernization
- Understanding complex, undocumented codebases
- Learning modern alternatives to outdated patterns
- Reducing technical debt in existing projects
- 🔮 AI-Powered Code Analysis: Leverages Hugging Face's GPT OSS 20B model for intelligent code understanding
- ⚡ Modern Code Generation: Converts legacy patterns to modern equivalents (callbacks → async/await, jQuery → vanilla JS, etc.)
- 📚 Intelligent Explanations: Provides detailed, plain-English explanations of code transformations
- 🔒 Secure Code Input: Safe and secure interface for submitting sensitive legacy code
- 💾 Transformation History: Save and manage your code modernization projects (optional user profiles)
- 🎨 Beautiful UI: Modern, responsive interface built with Tailwind CSS and Shadcn/UI
- ⚡ Fast Performance: Built on Next.js 14 with App Router for optimal performance
| Category | Technology |
|---|---|
| Frontend | Next.js 14 (App Router), React, TypeScript |
| Styling | Tailwind CSS, Shadcn/UI |
| Backend | Python FastAPI |
| AI/ML | Hugging Face API (GPT OSS 20B) |
| Development | Vite, ESLint, Prettier |
- Node.js (v18 or higher)
- Python (v3.8 or higher)
- npm or yarn package manager
-
Clone the repository
git clone https://github.com/yourusername/digital-necromancer.git cd digital-necromancer -
Install Frontend Dependencies
# Navigate to frontend directory cd src/gptoss npm install
-
Install Backend Dependencies
# Navigate to backend directory (assuming backend is in separate folder) cd ../backend pip install -r requirements.txt
-
Set up Environment Variables
Create a
.env.localfile in the frontend root and.envin the backend root:Frontend (.env.local):
NEXT_PUBLIC_API_URL=http://localhost:8000
Backend (.env):
HUGGINGFACE_API_KEY=your_huggingface_token_here CORS_ORIGINS=http://localhost:3000
-
Start the Development Servers
Backend (Terminal 1):
cd backend uvicorn main:app --reload --port 8000Frontend (Terminal 2):
cd src/gptoss npm run dev -
Open your browser
Navigate to
http://localhost:3000to see the application running.
- Paste Your Legacy Code: Use the secure input interface to submit your old code
- Select Transformation Type: Choose the type of modernization you need
- AI Analysis: The system analyzes your code using advanced AI models
- Review Results: Get modernized code alongside detailed explanations
- Save & Export: Save your transformations and export the results
Screenshot placeholder: Add a screenshot of the main interface showing the before/after code comparison
What makes Digital Necromancer special:
- 🎯 Real Problem, Real Solution: Addresses a $85B industry pain point
- 🤖 AI-First Approach: Leverages cutting-edge open-source AI models
- ⚡ Full-Stack Excellence: Modern tech stack with optimal performance
- 🎨 User-Centric Design: Intuitive interface that anyone can use
- 🔧 Production Ready: Scalable architecture ready for real-world deployment
Technical Innovation:
- Custom AI prompting for code analysis and transformation
- Real-time code processing with FastAPI backend
- Modern React components with TypeScript safety
- Responsive design that works on all devices
Future Roadmap:
- Support for more programming languages (Go, Rust, Swift)
- Integration with GitHub for direct repository processing
- AI-powered code review and security analysis
- Team collaboration features
- Enterprise deployment options
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Frontend │ │ Backend │ │ Hugging Face │
│ (Next.js) │◄──►│ (FastAPI) │◄──►│ AI Models │
│ │ │ │ │ │
└─────────────────┘ └─────────────────┘ └─────────────────┘
| Variable | Description | Required | Default |
|---|---|---|---|
HUGGINGFACE_API_KEY |
Your Hugging Face API token for AI model access | Yes | - |
NEXT_PUBLIC_API_URL |
Backend API URL for frontend requests | Yes | http://localhost:8000 |
CORS_ORIGINS |
Allowed CORS origins for the backend | Yes | http://localhost:3000 |
We welcome contributions from the community! Here's how you can help:
- Fork the repository
- Create a feature branch
git checkout -b feature/amazing-feature
- Commit your changes
git commit -m 'Add some amazing feature' - Push to the branch
git push origin feature/amazing-feature
- Open a Pull Request
- Follow the existing code style and conventions
- Add tests for new features
- Update documentation as needed
- Ensure all tests pass before submitting
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
You are free to use this project by:
- Creating your own Hugging Face token at Hugging Face
- Setting up your environment by adding your token to the backend
.envfile - Running the application following the installation instructions above
The Apache 2.0 license allows you to freely use, modify, and distribute this software for both personal and commercial purposes.
- Hugging Face for providing powerful AI models
- The open-source community for the amazing tools and libraries
- All contributors who help improve this project
If you encounter any issues or have questions:
- Open an issue on GitHub
- Check the documentation
- Join our community discussions
Made with ❤️ and a touch of digital necromancy